> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/ad/datarize.md).

# 데이터라이즈 연결

라플라스에 데이터라이즈를 연결하는 방법입니다. 데이터라이즈 콘솔에서 커넥터용 API 키를 발급받아 라플라스에 입력하고, CRM 메시지 캠페인 성과를 광고 데이터로 연결하는 순서와 연결 오류 해결 방법을 안내합니다.

이 가이드는 데이터라이즈의 CRM 메시지 캠페인 성과 데이터를 라플라스에 연결하는 방법을 안내합니다. 데이터라이즈 콘솔에서 발급받은 커넥터용 API 키를 라플라스에 입력하면 연결돼요.

## 연결 절차 개요 <a href="#overview" id="overview"></a>

1. 데이터라이즈 콘솔의 **설정** > **API 키**에서 용도를 **커넥터용**으로 골라 API 키를 발급받아요.
2. 라플라스 **데이터라이즈 연결** 화면에서 **데이터 연결**을 눌러 API 키를 입력하고 **연결하기**를 눌러요.
3. 키가 확인되면 **데이터라이즈 연결이 완료되었습니다.** 안내가 보이고, 그 키를 발급한 사이트가 바로 수집 대상으로 추가돼요.

## 사전 준비 <a href="#ready" id="ready"></a>

* 데이터라이즈 사이트의 **owner** 또는 **admin** 계정 (viewer 계정은 키 목록만 볼 수 있고 키를 만들 수 없어요)
* 구독 중이거나 결제 대기 중인 데이터라이즈 사이트 (무료 체험 중인 사이트는 키를 발급할 수 없어요)
* 라플라스 계정

{% hint style="info" %}
**API 키 하나는 데이터라이즈 사이트 하나에 묶여요.** 사이트가 여러 개라면 사이트마다 키를 발급받아 하나씩 연결해 주세요. 한 사이트는 라플라스 프로젝트 하나에만 연결할 수 있어요.
{% endhint %}

***

## Step 1. 데이터라이즈에서 API 키 발급 <a href="#api-key" id="api-key"></a>

1. 데이터라이즈 콘솔에 owner 또는 admin 계정으로 로그인한 뒤 **설정** > **API 키**를 열어 주세요.
2. 키 이름을 적고, 용도에서 **커넥터용**을 고른 뒤 약관에 동의해 키를 만들어 주세요.
3. 만든 키(`dtr_api_`로 시작)를 바로 복사해 안전한 곳에 보관해 주세요.

{% hint style="warning" %}
**키는 만들 때 한 번만 보여요.** 복사하지 못했다면 같은 방법으로 키를 새로 만들어 주세요. API 키는 비밀번호와 같은 역할이니 다른 사람에게 공유하거나 공개된 곳에 올리지 마세요.
{% endhint %}

***

## Step 2. 라플라스에서 데이터라이즈 연결 <a href="#step2" id="step2"></a>

1. 왼쪽 레일의 **데이터 연결**을 누른 뒤, 탐색 패널의 **커넥터 검색**에 데이터라이즈를 입력하거나 **광고 채널 연결** 카테고리에서 **데이터라이즈 연결**을 눌러 주세요(1). **데이터라이즈 연결** 화면 머리글 오른쪽의 **데이터 연결**을 눌러 연결 창을 열어 주세요(2).

   ![데이터라이즈 연결 화면과 머리글의 데이터 연결 버튼](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-861cddc555f53ea1c8f001252b3eb46852a777e6%2Fstartguide__connect__ad__datarize__01.png?alt=media)
2. **데이터라이즈 데이터 연결** 창의 **API 키** 칸에 Step 1에서 복사한 키를 앞뒤 공백 없이 붙여 넣고(1) **연결하기**를 눌러 주세요(2). 키를 확인하는 동안 **새로운 데이터라이즈 커넥션을 추가하는 중입니다.** 창이 잠시 보여요.

   ![데이터라이즈 데이터 연결 창 API 키 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-ff3b8bb4c705dbf953e3a66c2fdf8fce7ade1928%2Fstartguide__connect__ad__datarize__02.png?alt=media)
3. 키가 확인되면 **데이터라이즈 연결이 완료되었습니다.** 안내가 보여요. 데이터라이즈는 키 하나에 사이트가 하나라서, 키를 발급한 사이트가 바로 수집 대상으로 추가되고 수집이 시작돼요. 이어서 **데이터 소스 선택** 창이 열리면 **연결 가능한 신규 데이터 소스가 없습니다.** 가 보이는데, 이미 추가됐다는 뜻이니 **취소**를 눌러 닫아 주세요(1).

   ![데이터 소스 선택 창은 취소로 닫기](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-053df6e8f59c66d6ee8a547ba79e2aedcedcca57%2Fstartguide__connect__ad__datarize__03.png?alt=media)

* 연결한 사이트는 **데이터라이즈 연결** 화면의 **연결된 데이터** 표에 보여요. 행 오른쪽 ⋯ 버튼에서 **최신화**, **인증 갱신**, **삭제**를 할 수 있습니다.

{% hint style="info" %}
**어떤 데이터가 들어오나요?**

👉 데이터라이즈 CRM 메시지(알림톡, 브랜드 메시지, 문자, LINE) 캠페인의 발송 수, 클릭, 발송 비용, 메시지로 이어진 주문과 매출이 광고 데이터로 들어와요. 캠페인은 캠페인으로, 발송 채널은 광고그룹으로, 소재는 광고로 보여요. 발송 비용은 VAT를 뺀 금액이에요.

💬 주문과 매출은 메시지를 받은 뒤 48시간 안에 방문해 구매한 것을 기준으로 세요. 메시지를 클릭한 뒤 24시간 안에 구매한 것만 따로 보는 값도 함께 들어와요.
{% endhint %}

{% hint style="info" %}
**데이터 연동이 왜 오래 걸리나요?**

👉 라플라스에서는 데이터라이즈의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 소요되는 시간 또한 데이터의 양이 많을수록 오래 걸릴 수도 있어요.

💬 진행 상황은 상단 바 오른쪽 **작업 · 데이터 상태**에서 확인할 수 있고, 연동이 완료되면 이메일로도 알려 드려요. 라플라스를 종료해도 수집은 계속되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

{% hint style="warning" %}
데이터라이즈는 지금 **베타 커넥터**예요. 수집 항목과 데이터 반영 시점이 바뀌거나 늦어질 수 있어요.
{% endhint %}

***

## 연결이 되지 않을 때 <a href="#error" id="error"></a>

**연결하기**를 누른 뒤 **데이터 연결 오류** 창이 열리면 창에 보이는 문구에 따라 아래처럼 해 주세요.

* **API 키가 올바르지 않거나 더 이상 쓸 수 없는 키입니다.**
  * 원인: 키가 잘못 입력됐거나, 만료(기본 1년), 폐기, 또는 90일 동안 쓰지 않아 비활성화된 키예요.
  * 조치: 데이터라이즈 **설정** > **API 키**에서 만든 키(`dtr_api_`로 시작)를 앞뒤 공백 없이 그대로 붙여 넣었는지 확인해 주세요. 쓸 수 없는 키라면 사이트 owner 또는 admin 계정으로 커넥터용 키를 새로 만들어 입력해 주세요. 비활성화 이유는 데이터라이즈 키 목록에서 볼 수 있어요.
* **데이터라이즈 사이트 구독이 끝나 API 키가 비활성화되었습니다.**
  * 원인: 데이터라이즈 사이트 구독이 끝났어요.
  * 조치: 먼저 데이터라이즈에서 사이트 구독을 갱신해 주세요. 구독이 끝난 뒤 다시 구독하면 이전 키는 다시 동작하지 않으니, 구독을 갱신한 다음 **설정** > **API 키**에서 커넥터용 키를 새로 만들어 연결해 주세요.
* **API 키 형식이 올바르지 않습니다. 공백 없이 키만 그대로 붙여 넣어 주세요.**
  * 원인: 키 앞뒤에 공백이나 다른 글자가 함께 붙여 넣어졌어요.
  * 조치: 키만 공백 없이 다시 붙여 넣어 주세요.
* **데이터라이즈 API 요청이 많습니다.**
  * 원인: 짧은 시간에 데이터라이즈 API 요청이 많이 들어갔어요.
  * 조치: 안내에 나온 시간만큼 기다린 뒤 다시 **연결하기**를 눌러 주세요.
* **데이터라이즈 서버가 응답하지 않습니다. 잠시 후 다시 시도해 주세요.**
  * 원인: 데이터라이즈 쪽에 일시적인 문제가 있어요.
  * 조치: 잠시 후 다시 시도해 주세요. 계속되면 담당 매니저에게 문의해 주세요.
* **이미 연결된 데이터라이즈 사이트입니다. 한 사이트는 하나의 프로젝트에만 연결할 수 있습니다.**
  * 원인: 이 키의 사이트가 이미 다른 라플라스 프로젝트에 연결돼 있어요.
  * 조치: 그 사이트를 연결한 담당자에게 확인하고, 그 데이터를 함께 보려면 그 프로젝트에 멤버로 초대받아 주세요. 누가 연결했는지 모르겠다면 아래 채팅 상담으로 문의해 주세요.

***

## 인증 갱신 <a href="#reauth" id="reauth"></a>

키가 만료되거나 비활성화되면 라플라스가 데이터를 가져올 수 없어요. 그때는 **연결된 데이터** 표에서 그 사이트 행의 ⋯ 버튼 > **인증 갱신**을 눌러, 같은 사이트에서 새로 만든 커넥터용 키를 입력하고 **연결하기**를 눌러 주세요.

{% hint style="warning" %}
**인증 갱신에는 그 연결의 사이트에서 발급한 키를 입력해 주세요.** 다른 사이트의 키를 입력하면 **다른 사이트의 키입니다** 안내가 보이고 기존 연결은 다시 인증되지 않아요. 입력한 키는 그 키를 발급한 사이트의 연결에 반영돼요(그 사이트의 연결이 없으면 새로 추가하고, 있으면 그 연결을 다시 인증해요).
{% endhint %}

***

## 연결 해제 <a href="#disconnect" id="disconnect"></a>

연결 해제는 라플라스의 **데이터라이즈 연결** 화면에서 해 주세요. **연결된 데이터** 표에서 해제할 사이트 행의 ⋯ 버튼 > **삭제**를 누르면 돼요. 데이터라이즈의 API 키는 라플라스에서 지워지지 않으니, 더 쓰지 않는다면 데이터라이즈 **설정** > **API 키**에서 폐기해 주세요.

***

## 전담 매니저에게 요청하기

데이터라이즈 연결에 어려움이 있으신가요?

하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 도움을 드리도록 하겠습니다.

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)
