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

# 몰로코 Ads 연결

라플라스에 몰로코 Ads(Moloco Ads)를 연결하는 방법입니다. Moloco Ads에서 API 키를 만들고 라플라스에 입력해 광고 성과 데이터를 연결하는 순서와 연결 오류 해결 방법을 안내합니다.

이 가이드는 몰로코 Ads(Moloco Ads) 광고 성과 데이터를 라플라스에 연결하는 방법을 안내합니다. Moloco Ads에서 만든 API 키 하나를 라플라스에 입력하면 연결돼요.

{% hint style="info" %}
**몰로코 Ads 연결은 베타입니다.** 연결 화면의 커넥터 이름 옆에 **베타** 표시가 보여요. 연결하다 막히는 부분이 있으면 아래 채팅 상담으로 알려 주세요.
{% endhint %}

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

1. Moloco Ads에서 API 키를 만들어요.
2. 라플라스 **몰로코 Ads 연결** 화면에서 **데이터 연결**을 눌러 API 키를 입력하고 **연결하기**를 눌러요. 키가 확인되면 **몰로코 Ads 연결이 완료되었습니다.** 안내가 보여요.
3. **데이터 소스 선택** 창에서 광고 계정을 고르고 **데이터 연결**을 눌러요. 수집이 시작되고 **연결된 데이터** 표에 그 연결이 보여요.

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

* 광고 계정에 접근할 수 있는 Moloco Ads 사용자 계정
* Moloco Ads에서 만든 API 키
* 라플라스 계정

{% hint style="info" %}
**API 키 하나는 워크플레이스 하나에 연결돼요.** 키를 만든 사용자가 볼 수 있는 그 워크플레이스의 광고 계정이 데이터 소스로 들어와요. 워크플레이스가 여러 개라면 워크플레이스마다 API 키를 만들어 하나씩 연결해 주세요.
{% endhint %}

***

## Step 1. Moloco Ads에서 API 키 만들기 <a href="#api-key" id="api-key"></a>

1. Moloco Ads에 로그인합니다.
2. **User settings** > **API Access**로 이동해 **Create API Key**를 누릅니다.
3. 키 권한은 **읽기 전용(read-only)** 으로 만드는 것을 권장해요. 라플라스는 광고 성과를 읽기만 합니다.
4. 키에는 만료일을 정해야 해요. 만료일이 지나면 라플라스가 데이터를 가져올 수 없으니, 그 전에 새 키로 **인증 갱신**을 해 주세요(아래 [인증 갱신](#reauth)).
5. 만든 API 키를 복사해 안전한 곳에 보관합니다.

{% hint style="warning" %}
**API 키는 비밀번호와 같은 역할이에요.** 다른 사람에게 공유하거나 공개된 곳에 올리지 마세요. 라플라스에 입력한 키는 암호화되어 저장됩니다.
{% endhint %}

***

## Step 2. 라플라스에서 몰로코 Ads 연결 <a href="#step2" id="step2"></a>

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

   ![몰로코 Ads 연결 화면과 머리글의 데이터 연결 버튼](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-adc27d2f3267ba180c1592407da29d48545872b5%2Fstartguide__connect__ad__moloco-ads__01.png?alt=media)
2. **몰로코 Ads 데이터 연결** 창의 **API 키 정보**에 Step 1에서 보관한 **API 키**를 입력하고(1) **연결하기**를 눌러 주세요(2). 키를 확인하는 동안 **새로운 몰로코 Ads 커넥션을 추가하는 중입니다.** 창이 잠시 보여요.

   ![몰로코 Ads 데이터 연결 창 API 키 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-275b205e528c1546024d3d2e39e27ef98e2a02c4%2Fstartguide__connect__ad__moloco-ads__02.png?alt=media)
3. 키가 확인되면 **몰로코 Ads 연결이 완료되었습니다.** 안내와 함께 **데이터 소스 선택** 창이 열려요. 수집할 광고 계정을 선택하고(1) **데이터 연결**을 눌러 수집을 시작해 주세요(2).

   ![데이터 소스 선택에서 광고 계정 선택 후 데이터 연결](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-d8fdd2f7a494b9f49094c4c5f63473749959e8f7%2Fstartguide__connect__ad__moloco-ads__03.png?alt=media)

* **데이터 연결**을 누르기 전에 창을 닫았다면 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **데이터 소스 추가**를 눌러 같은 창을 다시 열고 **데이터 연결**을 눌러 주세요.
* 연결한 워크플레이스는 **몰로코 Ads 연결** 화면의 **연결된 데이터** 표에 보여요. 행 오른쪽 ⋯ 버튼에서 **최신화**, **데이터 소스 추가**, **인증 갱신**, **삭제**를 할 수 있습니다.

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

👉 라플라스에서는 몰로코 Ads의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 처음 연결하면 지난 기간의 광고 성과를 함께 가져오고, Moloco Ads API는 광고 계정마다 호출 횟수를 제한하기 때문에 시간이 더 걸릴 수 있어요.

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

***

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

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

* **API 키가 올바르지 않습니다. 다시 확인해 주세요.**
  * 원인: API 키가 잘못 입력됐거나, 만료일이 지났거나, Moloco Ads에서 삭제한 키예요.
  * 조치: Moloco Ads에서 만든 API 키를 앞뒤 공백 없이 그대로 입력했는지 확인해 주세요. 키가 만료되었거나 삭제되었다면 **User settings** > **API Access**에서 새 API 키를 만들어 입력해 주세요.
* **이 API 키로 볼 수 있는 광고 계정이 없습니다. 광고 계정에 접근할 수 있는 사용자로 API 키를 만들어 입력해 주세요.**
  * 원인: 키를 만든 사용자가 볼 수 있는 광고 계정이 없어요.
  * 조치: 광고 계정에 접근 권한이 있는 사용자로 로그인해 API 키를 다시 만들어 입력해 주세요.
* **Moloco Ads API 요청이 많습니다. 잠시 후에 다시 시도해 주세요.**
  * 원인: 짧은 시간에 같은 API 키로 요청이 많이 들어갔어요.
  * 조치: 잠시 기다린 뒤 다시 **연결하기**를 눌러 주세요.
* **Moloco Ads 서버가 일시적으로 응답하지 않습니다. 잠시 후 다시 시도해 주세요.**
  * 원인: Moloco Ads 쪽에 일시적인 문제가 있어요.
  * 조치: 잠시 후 다시 시도해 주세요. 계속되면 담당 매니저에게 문의해 주세요.
* **이미 연결된 몰로코 Ads 워크플레이스입니다.**
  * 원인: 이 키의 워크플레이스가 이미 라플라스에 연결돼 있어요.
  * 조치: 그 워크플레이스를 연결한 담당자에게 확인해 주세요. 그 데이터를 함께 보려면 그 프로젝트에 멤버로 초대받아 주세요. 누가 연결했는지 모르겠다면 아래 채팅 상담으로 문의해 주세요.

***

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

연결한 뒤에는 라플라스가 API 키로 접속 토큰을 주기적으로 새로 받아 연결을 유지해요. 다만 **API 키 자체의 만료일이 지나거나 키를 삭제하면** 라플라스가 데이터를 가져올 수 없어요.

{% hint style="danger" %}
같은 워크플레이스에서 API 키를 새로 만들었다면 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **인증 갱신**을 눌러 주세요. **연결된 몰로코 Ads 워크플레이스의 API 키를 다시 입력해 주세요. 다른 워크플레이스의 키로는 이 연결을 다시 인증할 수 없습니다.** 안내와 함께 입력 창이 열려요. 새 API 키를 입력하고 **연결하기**를 눌러 주세요.
{% endhint %}

{% hint style="warning" %}
**인증 갱신 창에는 이 연결의 워크플레이스에서 만든 키를 넣어 주세요.** 다른 워크플레이스의 키를 넣으면 기존 연결은 다시 인증되지 않고, 그 키의 워크플레이스가 새 연결로 추가돼요. 이때 **다른 워크플레이스의 키입니다** 창이 열려요.

1. 창을 닫아 주세요.
2. 잘못 추가된 연결은 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **삭제**를 눌러 지워 주세요. 그 워크플레이스도 연결해 둘 생각이라면 그대로 두셔도 돼요.
3. 다시 인증할 연결의 워크플레이스에서 만든 API 키를 준비해, 그 연결 행의 ⋯ 버튼 > **인증 갱신**에 다시 입력해 주세요.
   {% endhint %}

***

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

연결 해제는 라플라스의 **몰로코 Ads 연결** 화면에서 해 주세요. **연결된 데이터** 표에서 해제할 연결 행의 ⋯ 버튼 > **삭제**를 누르면 돼요. Moloco Ads의 API 키는 라플라스에서 지워지지 않으니, 더 쓰지 않는다면 Moloco Ads **User settings** > **API Access**에서 직접 삭제해 주세요.

***

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

몰로코 Ads 연결에 어려움이 있으신가요?

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

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

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