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

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

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

매체

네이버 검색광고

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

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

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

연동을 진행하실 검색광고 계정에 대해 [계정 책임자] 권한을 보유한 경우에만 API 발급이 가능합니다.

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

몰로코

계정 ID

1. 몰로코 홈페이지 로그인 후 상단 프로필 아이콘 버튼 - My ad accounts 메뉴를 선택합니다.

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

API Key

몰로코 공식 링크에 따라 각 워크스페이스별로 API Key를 생성합니다.

• 몰로코 API Key는 한 번 생성하면 비공개처리가 되어 몰로코 사이트 내에서 확인하실 수 없습니다.

• 바로 조직 자산 등록 진행하시거나 별도로 저장해 놓으시는 것을 추천드립니다.

Workspace ID

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

애플 서치애즈

애플서치애즈는 계정 관리자가 동시에 API 계정 관리자일 수 없어 API 계정 관리자 전용 계정이 필요합니다.

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

1. 먼저 “계정 관리자 권한”을 가진 계정으로 로그인 해 줍니다.

   • Apple Search Ads : 상단 메뉴바 ‘로그인’ → ‘Advanced’ 선택하여 로그인

   • 연동하시려는 광고 계정의 계정 관리자 권한을 가진 계정

2. Xpert에 연동하시고자 하는 광고 계정에 API 계정 관리자용 계정을 API 계정 관리자로 초대해줍니다.

   
3. API 계정 관리자 권한을 가진 계정으로 애플 서치애즈에 로그인 후 액세스를 허용하려는 광고 계정 - Settings 를 클릭해 설정 페이지로 접속합니다.

1. Client Credentials 페이지에서 Client ID, Team ID, Key ID를 확인할 수 있습니다.

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

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

당근 (BETA)

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

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

트래커

에어브릿지

API Token / App Name

1. 에어브릿지에 로그인 후 등록할 앱을 목록에서 선택합니다.

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

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

앱스플라이어

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

API Token

1. 앱스플라이어에 로그인합니다.

2. 상단 프로필 아이콘 - Security center 메뉴를 클릭합니다.

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

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

카페24

Mall ID

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

Redirect URL/Client 값

1. 카페24 개발자센터(링크)에 접속합니다.

2. Apps > App 관리에 접속해 App을 등록합니다.

   • ADD PRODUCT를 클릭한 후 App 유형을 Web으로 선택해 App을 등록합니다. (관리 상품명은 자유롭게 입력해도 무방합니다)

   

   
3. App URL 및 Redirect URL을 입력합니다.

   • App URL: https://xpert.lever.me/ 를 입력합니다.

   • Redirect URL: Xpert에서 복사한 링크를 입력합니다.

   
4. 'API 정보'에서 아래와 같이 쇼핑몰 운영자 권한을 추가합니다.

   • 앱: Read + Write

   • 상품: Read

   • 주문: Read

   • 회원: Read

   • 매출통계: Read

   • 접속통계: Read

   
5. 카페24 페이지에 입력한 내용이 저장되었는지 확인합니다.

6. '인증정보'에서 Client ID와 Client Secret Key를 복사한 후 Xpert에 입력합니다.

   

로그인 계정

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

데이터 제공 범위

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

• 카페24 어드민: 주문/매출 데이터 수집이 가능합니다.

• 카페24 애널리틱스: cafe_mkt 파라미터로 심겨져 있는 데이터(접속 통계 데이터)를 제외한 나머지데이터 수집이 가능합니다.