Moloco Report API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Report API | API | 집계 지표 | ✅ | ✅ | ✅ | ✅ | ✅ |
Report API는 집계 데이터 인터페이스로, 일정 기간의 지표 데이터를 반환하며 비용, 수익, 노출, 클릭, 전환 등의 데이터가 포함됩니다
통합 절차
- Moloco 계정에 로그인하여 API Key를 생성합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Moloco Report API 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. Moloco 백엔드에서 정보 가져오기
1.1 API Key 가져오기
API를 호출하기 전에 먼저 API Key를 가져와야 합니다. Moloco 계정에 로그인하여 오른쪽 상단의 유저 설정 메뉴에서 API Access 섹션을 찾습니다.
이어서 Create API Key를 클릭하여 새 Moloco API Key를 생성합니다. 이전에 생성한 API Key가 있다면 기존 API Key를 그대로 사용할 수도 있습니다. API Key 값은 따로 보관해 두십시오.
1.2 광고 계정 ID 가져오기
이어서 데이터를 수집할 모든 광고 계정의 ID도 가져와야 합니다. 아래 그림을 참고하여 광고 계정 ID를 확인할 수 있습니다. 여러 광고 계정을 설정할 수 있으므로 데이터를 수집할 모든 광고 계정의 ID를 가져오는 것을 권장합니다
2. 계획 설정
Moloco 인증 정보를 가져온 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Moloco Report API를 설정할 수 있습니다. 다음은 Moloco의 설정 화면입니다:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 Moloco 백엔드에서 가져온 정보를 입력합니다
- API Key: Moloco에서 생성한 API Key를 입력하십시오
- Ad Account ID: 데이터를 수집할 광고 계정의 ID. 여러 개인 경우 ","로 구분하십시오
2.2 동기화
동기화 모듈에서 AE 시스템이 Moloco Report API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다. 수집한 데이터도 데이터양에 포함되므로 너무 긴 기간의 데이터를 정기 수집하지 않는 것을 권장합니다
2.3 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.4 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름, 데이터 수집 차원 등입니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | group_by | 데이터의 그룹 차원, 리스트 타입 |
| transfer | double_columns | 저장할 지표 필드. 수정하지 마십시오 |
- 그룹 차원
다음은 지원되는 그룹 차원이며, 기본적으로 모든 차원의 데이터를 가져옵니다. 각 차원은 여러 저장 필드에 대응하며, 아래 표에서 대응 관계를 확인할 수 있습니다. 조정이 필요하면 source.group_by를 수정하여 수집할 그룹 차원의 차원명을 입력하십시오
| 차원 | 저장 필드명 | 기본 여부 | 설명 |
|---|---|---|---|
| 기본 포함 | ad_account_currency | 예 | 광고 계정에서 사용하는 통화 |
| ad_account_id | 예 | 광고 계정 ID | |
| ad_account_title | 예 | 광고 계정 이름 | |
| DATE | date | 예 | 날짜 |
| APP_OR_SITE | app_id | 예 | App 고유 ID |
| app_os | 예 | App이 속한 플랫폼 | |
| app_store_id | 예 | APP 앱 스토어 ID | |
| app_title | 예 | App 이름 | |
| site_domain | 예 | 사이트 도메인 | |
| site_id | 예 | 사이트 ID | |
| site_title | 예 | 사이트 이름 | |
CAMPAIGN | campaign_country | 예 | 캠페인 대상 국가/지역 |
| campaign_id | 예 | 캠페인 ID | |
| campaign_title | 예 | 캠페인 이름 | |
| AD_GROUP | ad_group_id | 예 | 광고 그룹 ID |
| ad_group_title | 예 | 광고 그룹 이름 | |
| CREATIVE_GROUP | creative_group_id | 예 | 소재 그룹 ID |
| creative_group_title | 예 | 소재 그룹 이름 | |
CREATIVE | creative_id | 예 | 소재 ID |
| creative_main_asset_location | 예 | 소재 주소 URL | |
| creative_title | 예 | 소재 이름 | |
| creative_type | 예 | 소재 유형 | |
| EXCHANGE | exchange_id | 예 | 익스체인지 고유 ID |
SUB_PUBLISHER | sub_publisher_id | 예 | Sub Publisher ID |
| sub_publisher_title | 예 | Sub Publisher 이름 | |
| TRAFFIC | traffic_is_lat | 예 | LAT 활성화 여부, 불리언 값 |
| traffic_mmp_effective | 예 | 어트리뷰션 가능 여부 | |
| traffic_skan_bid | 예 | SKAN 응답 포함 여부 |
- 지표 필드
지원되는 지표 필드는 다음과 같습니다:
| 필드 | 설명 |
|---|---|
| impressions | 노출 수 |
| clicks | 클릭 수 |
| installs | 설치 수 |
| spend | UA 비용 |
| revenue | 수익화 수익 |
2.5 저장 규칙
- 데이터의 date 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다
- Report API 데이터의 기본 이벤트 이름은 -- moloco_report입니다
- 나머지 필드는 모두 저장됩니다
2.6 표준화 필드
다음 이벤트 속성은 표준화 처리됩니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| ad_account_id | te_ads_object.ad_account_id | 광고 계정 ID |
| campaign_title | te_ads_object.campaign_name | 캠페인 이름 |
| campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| ad_group_title | te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| ad_group_id | te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| creative_group_title | te_ads_object.ad_name | 광고 이름 |
| creative_group_id | te_ads_object.ad_id | 광고 ID |
| app_store_id | te_ads_object.app_id | 앱 ID |
| app_title | te_ads_object.app_name | 앱 이름 |
| app_os | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| campaign_country | te_ads_object.country | 국가/지역 코드 |
| ad_account_currency | te_ads_object.currency | 비용 또는 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| clicks | te_ads_object.clicks | 클릭 수 |
| installs | te_ads_object.installs | 전환 수(설치) |
| spend | te_ads_object.cost | UA 비용 |
| revenue | te_ads_object.revenue | 수익화 수익 |