> 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/karrot-ads.md).

# 당근 광고 연결

라플라스에 당근 광고를 연결하는 방법입니다. 광고 계정 하나의 OpenAPI 키(광고주 키)를 광고주 ID와 함께 입력하거나, 대행사 키만 입력해 위임받은 광고주를 골라 광고 성과 데이터를 연결하는 순서와 연결 오류 해결 방법을 안내합니다.

이 가이드는 당근 광고 성과 데이터를 라플라스에 연결하는 방법을 안내합니다. 당근 광고 OpenAPI 키는 두 가지 방법으로 연결할 수 있어요.

* **광고주 키**: 광고 계정 하나의 키예요. 당근 비즈니스 전문가모드에서 발급받은 키와 그 광고 계정의 광고주 ID를 함께 입력해요.
* **대행사 키**: 광고주를 위임받은 대행사의 키예요. 광고주 ID는 비워 두고 키만 입력하면, 위임받은 광고주를 불러와 수집할 광고주를 고를 수 있어요.

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

1. 당근 광고 OpenAPI 키를 준비해요. 광고주 키는 당근 비즈니스 전문가모드의 **고객센터** > **온라인 문의**에서 발급받고, 이때 고른 광고 계정의 번호가 광고주 ID예요. 대행사 키 발급은 당근 광고에 문의해 주세요.
2. 라플라스 **당근 광고 연결** 화면에서 **데이터 연결**을 눌러 OpenAPI 키를 입력하고 **연결하기**를 눌러요. 광고주 키면 광고주 ID도 함께 입력하고, 대행사 키면 광고주 ID를 비워 둬요.
3. 키가 확인되면 **당근 광고 연결이 완료되었습니다.** 안내와 함께 **데이터 소스 선택** 창이 열려요. 광고주 키는 그 광고 계정이 바로 수집 대상으로 추가되고, 대행사 키는 위임받은 광고주 중 수집할 광고주를 골라 **데이터 연결**을 눌러요.

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

* 당근 비즈니스 **전문가모드** 광고 계정 (OpenAPI는 전문가모드 광고 계정에서만 쓸 수 있어요. 간편모드 광고 계정은 키를 발급받을 수 없어요)
* 광고주 키로 연결한다면 그 광고 계정의 광고주 ID(숫자)와 OpenAPI 키, 대행사 키로 연결한다면 대행사 키
* 라플라스 계정

{% hint style="info" %}
**광고주 키 하나는 광고 계정 하나에 연결돼요.** 광고 계정이 여러 개라면 광고 계정마다 키를 발급받아 하나씩 연결해 주세요. 광고주를 위임받은 대행사라면 대행사 키 하나로 위임받은 광고주를 함께 연결할 수 있어요.
{% endhint %}

***

## Step 1. 당근 광고 OpenAPI 키 준비 <a href="#api-key" id="api-key"></a>

### 1-1. 광고주 키 발급 <a href="#advertiser-key" id="advertiser-key"></a>

{% hint style="warning" %}
**키를 새로 발급받으면 그 광고 계정의 기존 키는 바로 폐기돼요.** 다른 시스템에서 이미 쓰고 있는 키가 있다면 새로 발급받지 말고 그 키를 그대로 라플라스에 입력해 주세요. 새로 발급받았다면 기존 키를 쓰던 시스템에도 새 키를 넣어 주세요.
{% endhint %}

1. 당근 비즈니스 전문가모드에 로그인한 뒤, 왼쪽 메뉴 하단 **고객센터**의 **온라인 문의**를 눌러 주세요. 새 창에서 온라인 문의 페이지가 열려요.
2. **+ 문의하기**를 누르고 문의 유형에서 **광고 도구 및 전환** > **OpenAPI 키 발급**을 선택해 주세요.
3. 키를 발급받을 광고 계정(광고주 ID)을 선택하고 문의를 등록해 주세요. **이때 선택한 광고 계정의 광고주 ID를 따로 적어 두세요.** Step 2에서 키와 함께 입력해요.
4. 문의를 등록하면 키를 확인할 수 있는 링크가 바로 와요. 링크를 열어 **OpenAPI 키**를 복사해 안전한 곳에 보관해 주세요.

{% hint style="warning" %}
**키 확인 링크는 받은 뒤 24시간 안에 한 번만 열 수 있어요.** 열자마자 키를 저장해 주세요. 저장하지 못했다면 같은 방법으로 다시 신청해 새 키를 받아 주세요. OpenAPI 키는 비밀번호와 같은 역할이니 다른 사람에게 공유하거나 공개된 곳에 올리지 마세요.
{% endhint %}

자세한 발급 방법은 당근 비즈니스 [당근 광고 OpenAPI 안내](https://businessdaangn.gitbook.io/business.daangn/ads-pro/tools/openapi)에서도 확인할 수 있어요.

### 1-2. 대행사 키 <a href="#agency-key" id="agency-key"></a>

대행사 키 발급은 당근 광고에 문의해 주세요. 대행사 키로 연결하면 당근 광고에서 그 대행사에 위임된 광고주를 불러와요. 대행사 키도 비밀번호와 같은 역할이니 다른 사람에게 공유하거나 공개된 곳에 올리지 마세요.

***

## Step 2. 라플라스에서 당근 광고 연결 <a href="#step2" id="step2"></a>

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

   <figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-8b0d3fe737bacecdb481e02db72b3deb7a9759d5%2Fstartguide__connect__ad__karrot-ads__01.png?alt=media" alt="당근 광고 연결 화면과 머리글의 데이터 연결 버튼"><figcaption></figcaption></figure>
2. **당근 광고 데이터 연결** 창의 **광고 계정 정보**에 키를 입력하고(1) **연결하기**를 눌러 주세요(2). 광고주 키면 **광고주 ID (선택)** 칸에 Step 1에서 적어 둔 광고주 ID를 숫자만 입력하고 **OpenAPI 키** 칸에 키를 입력해요. 대행사 키면 **광고주 ID (선택)** 칸은 비워 두고 **OpenAPI 키** 칸에 대행사 키만 입력해요. 칸 아래에도 **광고주 키면 그 광고주의 ID를 입력하고, 대행사 키면 비워 두세요.** 라고 안내돼요. 키를 확인하는 동안 **새로운 당근 광고 커넥션을 추가하는 중입니다.** 창이 잠시 보여요.

   <figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-b0866e638545d28c9cc2a86a51fd04ed22904e39%2Fstartguide__connect__ad__karrot-ads__02.png?alt=media" alt="당근 광고 데이터 연결 창의 광고주 ID (선택) 칸과 OpenAPI 키 입력"><figcaption></figcaption></figure>
3. 키가 확인되면 **당근 광고 연결이 완료되었습니다.** 안내와 함께 **데이터 소스 선택** 창이 열려요. 이어지는 단계는 연결한 키에 따라 달라요. 광고주 키는 아래 2-1, 대행사 키는 2-2를 따라 주세요.

### 2-1. 광고주 키로 연결했다면 <a href="#advertiser-connected" id="advertiser-connected"></a>

광고주 키는 키 하나에 광고 계정이 하나라서, 입력한 광고 계정이 바로 수집 대상으로 추가되고 수집이 시작돼요. **데이터 소스 선택** 창에는 **연결 가능한 신규 데이터 소스가 없습니다.** 가 보이는데, 이미 추가됐다는 뜻이니 **취소**를 눌러 닫아 주세요(1).

<figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-73fa9ec97821ceff66083475dac9484560505bd1%2Fstartguide__connect__ad__karrot-ads__03.png?alt=media" alt="광고주 키 연결 뒤 데이터 소스 선택 창은 취소로 닫기"><figcaption></figcaption></figure>

### 2-2. 대행사 키로 연결했다면 <a href="#agency-connected" id="agency-connected"></a>

**데이터 소스 선택** 창에 대행사 키로 위임받은 광고주가 광고주 이름과 광고주 ID로 보여요. 수집할 광고주를 선택하고(1) **데이터 연결**을 눌러 수집을 시작해 주세요(2). 목록 머리글의 체크박스를 누르면 모두 선택돼요.

<figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-3e39774877ea07111ead77c51623ea3f7584cb90%2Fstartguide__connect__ad__karrot-ads__04.png?alt=media" alt="대행사 키 연결 뒤 데이터 소스 선택 창에서 광고주 선택 후 데이터 연결"><figcaption></figcaption></figure>

* **데이터 연결**을 누르기 전에 창을 닫았다면 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **데이터 소스 추가**를 눌러 같은 창을 다시 열고 **데이터 연결**을 눌러 주세요.
* 나중에 광고주를 새로 위임받았다면 아래 [새로 위임받은 광고주 추가하기](#refresh)를 따라 주세요.

### 연결한 뒤 <a href="#connected" id="connected"></a>

연결한 계정은 **당근 광고 연결** 화면의 **연결된 데이터** 표에 보여요. 광고주 키 연결은 광고주 ID로, 대행사 키 연결은 대표 광고주 이름과 나머지 광고주 수로 보여요. 행 오른쪽 ⋯ 버튼에서 **최신화**, **데이터 소스 추가**, **인증 갱신**, **삭제**를 할 수 있습니다. ⋯ 버튼의 **최신화**는 데이터 수집을 다시 실행해요. 새로 위임받은 광고주를 불러오는 것은 **데이터 소스 추가** 창의 **리스트 최신화**예요.

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

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

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

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

***

## 새로 위임받은 광고주 추가하기 <a href="#refresh" id="refresh"></a>

대행사 키로 연결한 뒤 당근 광고에서 광고주를 새로 위임받았다면, 그 광고주를 같은 연결에 추가할 수 있어요.

1. **연결된 데이터** 표에서 대행사 키 연결 행의 ⋯ 버튼 > **데이터 소스 추가**를 눌러 **데이터 소스 선택** 창을 열어 주세요.
2. **선택된 데이터 소스** 앞의 **리스트 최신화** 버튼(동그란 화살표)을 눌러 주세요(1). 저장된 대행사 키로 위임받은 광고주를 다시 불러와, 아직 연결에 없는 광고주만 목록에 추가해요. 새 광고주가 있으면 **새 데이터 소스 1개를 찾았습니다.** 처럼 찾은 수가 보이고, 없으면 **새로 추가된 데이터 소스가 없습니다.** 가 보여요.
3. 새로 추가된 광고주를 선택하고(2) **데이터 연결**을 눌러 수집을 시작해 주세요(3).

   <figure><img src="https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-6de09f79ddf6e09eff19ef717e9402ad6e11d0ec%2Fstartguide__connect__ad__karrot-ads__05.png?alt=media" alt="데이터 소스 선택 창에서 리스트 최신화 후 새 광고주 선택과 데이터 연결"><figcaption></figcaption></figure>

* 광고주 키 연결은 키 하나에 광고 계정이 하나라서, **리스트 최신화**를 눌러도 추가되는 광고주가 없어요.
* **저장된 인증 정보로 이 연결의 계정을 확인하지 못했습니다. 연결 목록에서 \[인증 갱신]으로 다시 인증한 뒤 최신화해 주세요.** 가 보이면 저장된 대행사 키가 더는 통하지 않는 거예요. 아래 [인증 갱신](#reauth)으로 지금 쓰는 대행사 키를 입력한 뒤 다시 눌러 주세요.

***

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

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

* **광고주 ID 또는 OpenAPI 키가 올바르지 않습니다. 다시 확인해 주세요.**
  * 원인: 광고주 ID와 함께 입력한 키를 당근 광고가 받지 않았어요. 광고주 ID와 키가 서로 맞지 않거나, 키가 잘못 입력됐거나, 새로 발급받아 폐기된 키예요.
  * 조치: 당근에서 발급받은 OpenAPI 키를 앞뒤 공백 없이 그대로 다시 입력해 주세요. 광고주 ID가 그 키를 발급받을 때 선택한 광고 계정의 ID인지 확인해 주세요. 그 뒤에 키를 다시 발급받았다면 예전 키는 폐기됐으니 새 키를 입력해 주세요.
* **광고주 ID를 입력해 주세요. 입력한 키가 대행사 키가 아니거나, 이 대행사 키에 위임된 광고주가 없습니다. 광고주 키라면 광고주 ID와 함께 다시 연결해 주세요.**
  * 원인: 광고주 ID를 비워 두고 연결했는데, 입력한 키로 위임받은 광고주를 불러오지 못했어요. 광고주 키를 광고주 ID 없이 입력했거나, 대행사 키에 위임된 광고주가 아직 없을 때 생겨요.
  * 조치: 광고주 키라면 그 키를 발급받은 광고 계정의 광고주 ID를 함께 입력해 다시 연결해 주세요. 대행사 키라면 당근 광고에서 그 대행사에 광고주가 위임돼 있는지 확인한 뒤 다시 연결해 주세요.
* **이 대행사 키는 다른 계정의 연결과 인증 정보를 함께 쓰고 있어 여기서 연결하거나 키를 바꿀 수 없습니다. 대행사에서 지금 쓰는 키인지 확인해 주세요. 키를 바꾸려면 새 키로 새 연결을 만들어 주세요.**
  * 원인: 같은 대행사 키로 다른 라플라스 계정에서도 연결해 두어, 그 연결과 인증 정보를 함께 쓰고 있어요. 다른 계정이 이미 새 키로 바꾼 예전 키로 새 연결을 만들거나, 그런 연결의 키를 **인증 갱신**으로 바꾸려 할 때 생겨요.
  * 조치: 대행사에서 지금 쓰는 키인지 확인해 주세요. 키를 바꾸려면 새 키로 새 연결을 만들어 주세요. 해결되지 않으면 아래 채팅 상담으로 문의해 주세요.
* **당근 광고 API 요청이 많습니다. 1분 뒤에 다시 시도해 주세요.**
  * 원인: 짧은 시간에 당근 광고 API 요청이 많이 들어갔어요. 다른 시스템에서 같은 키로 당근 광고 API를 많이 부르고 있을 때도 생겨요.
  * 조치: 1분 정도 기다린 뒤 다시 **연결하기**를 눌러 주세요.
* **당근 광고 서버가 응답하지 않습니다. 잠시 후 다시 시도해 주세요.**
  * 원인: 당근 광고 쪽에 일시적인 문제가 있어요.
  * 조치: 잠시 후 다시 시도해 주세요. 계속되면 담당 매니저에게 문의해 주세요.
* **이미 연결된 당근 광고 계정입니다.**
  * 원인: 같은 광고 계정이나 같은 대행사 키의 연결이 이미 라플라스에 있어요.
  * 조치: **연결된 데이터** 표에 그 연결이 있는지 확인해 주세요. 없다면 그 광고 계정을 연결한 담당자에게 확인하고, 그 데이터를 함께 보려면 그 프로젝트에 멤버로 초대받아 주세요. 누가 연결했는지 모르겠다면 아래 채팅 상담으로 문의해 주세요.

***

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

연결한 뒤에는 따로 갱신할 필요가 없어요. 라플라스가 연결을 유지합니다.

{% hint style="danger" %}
연결에 쓴 OpenAPI 키를 새로 발급받으면 기존 키가 바로 폐기돼서 라플라스가 데이터를 가져올 수 없어요. 키를 새로 발급받았다면 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **인증 갱신**을 눌러 새 OpenAPI 키를 입력하고 **연결하기**를 눌러 주세요. 인증 갱신 창에는 갱신할 연결이 보이고 키만 입력하면 돼요. 광고주 키 연결에는 그 광고주의 새 키를, 대행사 키 연결에는 새 대행사 키를 입력해 주세요. 같은 광고 계정으로 연결된 계정은 새 연결로 다시 추가할 수 없으니, 꼭 **인증 갱신**으로 입력해 주세요.
{% endhint %}

***

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

연결 해제는 라플라스의 **당근 광고 연결** 화면에서 해 주세요. **연결된 데이터** 표에서 해제할 연결 행의 ⋯ 버튼 > **삭제**를 누르면 돼요. 당근의 OpenAPI 키는 라플라스에서 지워지지 않아요.

***

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

당근 광고 연결에 어려움이 있으신가요?

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

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

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)

OpenAPI 키 발급이나 당근 광고 계정에 관한 문의는 당근 비즈니스 전문가모드의 **고객센터** > **온라인 문의**로 해 주세요.
