# 매체별 광고주 식별 정보 입력 가이드

XAP에 조직 자산을 등록하기 위해서는, 자산 developer 사이트에서 토큰 정보를 수집하고, business 사이트에서 광고 계정 ID를 얻어야 합니다.

하단 가이드에서는 매체별 광고주의 식별 정보 (customer\_id, app\_id, account\_id 등)를 확인하는 방법을 안내드리고 있습니다.

## 매체

### 네이버 검색광고

<figure><img src="/files/93QXtbWMY9w3cnYCWNbG" alt="" width="375"><figcaption></figcaption></figure>

#### Customer ID / 액세스 라이선스 / 비밀키

1. 네이버 통합광고주센터 > 내 프로필 > 광고 계정을 선택합니다.

<figure><img src="/files/pu0VYMVjUpYZg95v2oFl" alt=""><figcaption></figcaption></figure>

2. 좌측 \[도구] 메뉴 > SA API 사용 관리를 클릭하시면 필요한 정보를 찾을 수 있습니다.

<figure><img src="/files/wSDeZ4Xut8AFh4vRyuDd" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
연동을 진행하실 검색광고 계정에 대해 **\[계정 책임자] 권한을 보유한 경우에만 API 발급이 가능합니다.**

운영 관리자 또는 일반 멤버 권한 계정으로는 접근이 불가한 점 참고 부탁드립니다.
{% endhint %}

<figure><img src="/files/9FMKkosrHy6ByzQOjlvX" alt=""><figcaption></figcaption></figure>

### 몰로코

<figure><img src="/files/W86eDdhQOkoC99dYSC2r" alt=""><figcaption></figcaption></figure>

#### 계정 ID

1. [몰로코 홈페이지](https://portal.moloco.cloud/signin) 로그인 후 `상단 프로필 아이콘 버튼` - `My ad accounts 메뉴`를 선택합니다.

<figure><img src="/files/yzJiOoRMpjtvFsTh8MQ6" alt=""><figcaption></figcaption></figure>

2. User settings 메뉴 내 Email 란에서 계정 ID를 확인할 수 있습니다.

<figure><img src="/files/6SmJka1izcCyRxNCB6sS" alt=""><figcaption></figcaption></figure>

#### API Key

[몰로코 공식 링크](https://help.moloco.com/hc/en-us/articles/22420665601559-Create-and-manage-API-key)에 따라 **각 워크스페이스별로 API Key**를 생성합니다.

* 몰로코 API Key는 한 번 생성하면 비공개처리가 되어 몰로코 사이트 내에서 확인하실 수 없습니다.
* 바로 조직 자산 등록 진행하시거나 별도로 저장해 놓으시는 것을 추천드립니다.

#### Workspace ID

* `Workspace settings 메뉴` 내 상단 url 부분과, 페이지 내 정보 란에서 `Workspace ID`를 확인할 수 있습니다.

<figure><img src="/files/MEO3ymRtCKvsdO01SWm0" alt=""><figcaption></figcaption></figure>

### 애플 서치애즈

<figure><img src="/files/7zAT0mVyVGY6OtE1n7BO" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
애플서치애즈는 계정 관리자가 동시에 API 계정 관리자일 수 없어 API 계정 관리자 전용 계정이 필요합니다.

* API 계정 관리자용 계정을 새롭게 생성하시고 해당 계정에 조직에서 사용할 광고 계정에서 API 계정 관리자용 계정을 초대해주세요.
  {% endhint %}

1. 먼저 “계정 관리자 권한”을 가진 계정으로 로그인 해 줍니다.
   * [Apple Search Ads](https://searchads.apple.com/kr/) : 상단 메뉴바 ‘로그인’ → ‘Advanced’ 선택하여 로그인
   * 연동하시려는 광고 계정의 계정 관리자 권한을 가진 계정
2. Xpert에 연동하시고자 하는 광고 계정에 API 계정 관리자용 계정을 API 계정 관리자로 초대해줍니다.

   <figure><img src="/files/Gz1JuBobSxiwfxlas5Rz" alt=""><figcaption></figcaption></figure>
3. API 계정 관리자 권한을 가진 계정으로 [애플 서치애즈](https://idmsa.apple.com/IDMSWebAuth/signin?appIdKey=a01459d797984726ee0914a7097e53fad42b70e1f08d09294d14523a1d4f61e1\&rv=1\&path=%2Fcm%2Fapp)에 로그인 후 액세스를 허용하려는 광고 계정 - `Settings` 를 클릭해 설정 페이지로 접속합니다.

<figure><img src="/files/lgp9UeqxgOlwII339ytp" alt=""><figcaption></figcaption></figure>

4. Client Credentials 페이지에서 `Client ID`, `Team ID`, `Key ID`를 확인할 수 있습니다.&#x20;

* 최초 등록인 경우 Public Key를 등록해야 발급됩니다.

5. Public Key 공란에는 XAP 애플서치애즈 등록 모달 내 `Public Key 복사 버튼`을 클릭, 붙여넣기합니다. `Save 버튼`을 클릭해 XAP에 캠페인 관리 API 액세스 권한을 부여합니다.

<figure><img src="/files/QzNyGTZccSz7ZiFjcgaH" alt=""><figcaption></figcaption></figure>

### 당근 (BETA)

<figure><img src="/files/VMciHZ7goHRqeZHPh9rT" alt=""><figcaption></figcaption></figure>

매드업이 **당근 애즈 API 베타 테스터로 선정되어 관련 기능이 오픈되었습니다.**

매드업이 영업권을 대행 중인 당근 광고 계정은 필요 시 선택하여 연동이 가능하며, 그 외 계정의 경우에는 **매체 측에 직접 문의하여 API를 별도로 발급받아 진행해 주셔야 하는 점 참고 부탁드립니다.**

## 트래커

### 에어브릿지

<figure><img src="/files/wfoieOJ6bYmX3cDoZbgu" alt="" width="375"><figcaption></figcaption></figure>

#### API Token / App Name

1. [에어브릿지](https://app.airbridge.io/signin)에 로그인 후 등록할 앱을 목록에서 선택합니다.

<figure><img src="/files/BBhTzm4EG18zcDvZ4DQA" alt=""><figcaption></figcaption></figure>

2. 설정 > 에어브릿지 앱 설정 > **앱 이름**을 확인합니다.

<figure><img src="/files/Z1XRkKUyWuAXtJ6YuiTF" alt=""><figcaption></figcaption></figure>

3. 설정 > 토큰 관리 > **API 토큰**을 확인합니다.

<figure><img src="/files/rgpFc1GwmIdyOxwY6QiH" alt=""><figcaption></figcaption></figure>

### 앱스플라이어

<figure><img src="/files/dBS1WivN8ly1dvMqvTgG" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
앱스플라이어 토큰은 광고주 소유 계정 or 에이전시 계정에서만 확인할 수 있고, **팀 멤버 계정으로 확인이 어렵습니다.**\
팀 멤버 계정을 이용하시는 경우 계정 소유주에게 앱스플라이어 V2 토큰을 요청해주셔야 합니다.
{% endhint %}

#### API Token

1. [앱스플라이어](https://hq1.appsflyer.com/auth/login)에 로그인합니다.
2. 상단 `프로필 아이콘` - `Security center` 메뉴를 클릭합니다.

<figure><img src="/files/PVUwyTUo7KBQZBEOp9hS" alt=""><figcaption></figcaption></figure>

3. 토큰 관리 메뉴에 접속합니다.

<figure><img src="/files/IaH9NdNYN5q3sVHotLJa" alt=""><figcaption></figcaption></figure>

4. Token 테이블 내 Token을 복사 - XAP에 붙여넣기 해 등록합니다.

<figure><img src="/files/7V9vQBbLgUPCAsV1ZQMh" alt=""><figcaption></figcaption></figure>

### 카페24

<figure><img src="/files/At3TyLNXwEiQfjn1rX6Z" alt="" width="345"><figcaption></figcaption></figure>

#### Mall ID

카페24 대표운영자의 로그인 아이디를 입력합니다.

<figure><img src="/files/SbQE1yIOH03dwitCRTFp" alt="" width="369"><figcaption></figcaption></figure>

#### Redirect URL/Client 값

1. 카페24 개발자센터([링크](http://developers.cafe24.com/))에 접속합니다.
2. Apps > App 관리에 접속해 App을 등록합니다.

   * <mark style="color:blue;">`ADD PRODUCT`</mark>를 클릭한 후 App 유형을 `Web`으로 선택해 App을 등록합니다.\
     (관리 상품명은 자유롭게 입력해도 무방합니다)

   <figure><img src="/files/zZh57co4gKM8NBXSJIvW" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/C4rVRRhaGxdAwvPGIwkF" alt=""><figcaption></figcaption></figure>
3. App URL 및 Redirect URL을 입력합니다.

   * App URL: <https://xpert.lever.me/> 를 입력합니다.
   * Redirect URL: Xpert에서 복사한 링크를 입력합니다.

   <figure><img src="/files/zG96Tz5bQU469bQWdXFh" alt=""><figcaption></figcaption></figure>
4. 'API 정보'에서 아래와 같이 `쇼핑몰 운영자 권한`을 추가합니다.

   * 앱: Read + Write
   * 상품: Read
   * 주문: Read
   * 회원: Read
   * 매출통계: Read
   * 접속통계: Read

   <figure><img src="/files/OhAW8NVmwVAHUMFcaa8q" alt=""><figcaption></figcaption></figure>
5. 카페24 페이지에 입력한 내용이 저장되었는지 확인합니다.
6. '인증정보'에서 Client ID와 Client Secret Key를 복사한 후 Xpert에 입력합니다.

   <figure><img src="/files/IxdkHVMXRmLDqmgJYUOQ" alt=""><figcaption></figcaption></figure>

#### 로그인 계정

카페24 계정으로 로그인한 후 자산 추가를 완료합니다.

#### 데이터 제공 범위

카페24측에서 모든 데이터에 대한 API를 제공하고 있지 않아, 하기와 같은 데이터 제약이 존재합니다.

* **카페24 어드민:** 주문/매출 데이터 수집이 가능합니다.
* **카페24 애널리틱스:** cafe\_mkt 파라미터로 심겨져 있는 데이터(접속 통계 데이터)를 제외한 나머지데이터 수집이 가능합니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.xpert.lever.me/xpert_admin_page/xap/asset_mgmt/input_guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.