AppLovin Revenue Reporting API
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Revenue Reporting API | API | 집계 데이터 | ✅ | ✅ |
AppLovin은 Max 수익화 전용 집계 지표 API인 Revenue Reporting API도 제공합니다.
통합 절차
- AppLovin 백엔드에 로그인하여 Report Key를 가져옵니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 AppLovin Revenue Reporting API 계획을 추가하고 관련 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. Report Key 가져오기
AppLovin Revenue Reporting API 데이터를 연동하려면 먼저 Report Key를 가져와야 합니다. AppLovin 백엔드에 로그인하여 Account - Key에서 Report Key를 가져오고, 이 Key를 안전하게 보관하십시오
2. 계획 설정
Report Key를 가져온 후 AE 시스템에 로그인하여 서드파티 통합 모듈에서 새 계획을 설정할 수 있습니다. 다음은 AppLovin Revenue Reporting API의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 인증 정보 설정
인증 정보 아래의 인증 정보 설정 버튼을 클릭하고, 팝업 창에 인증 작업에서 가져온 정보를 입력합니다
API Key는 방금 가져온 Report Key입니다. 팝업 창의 API Key는 기본적으로 바로 입력할 수 없으므로, 먼저 오른쪽의 편집 아이콘을 클릭한 후 입력하십시오.
2.2 동기화
동기화 모듈에서 AE 시스템이 AppLovin Revenue Reporting API 데이터를 정기적으로 수집하는 전략을 설정할 수 있으며, 매일 특정 시각 또는 매시간 일정 기간의 데이터를 수집하도록 선택할 수 있습니다.
2.3 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.4 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 여기에는 데이터의 시간 집계 단위, 수집할 지표 필드와 차원, 저장 후 이벤트 이름 등이 포함됩니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후 이벤트 이름, 커스텀 가능 |
| source | metrics | 데이터의 지표, 리스트 타입. 계층마다 지원하는 metrics가 다르므로 입력 시 주의 필요 |
| group_by | 데이터의 그룹 차원, 리스트 타입. 계층마다 지원하는 group_by가 다르므로 입력 시 주의 필요 |
- 그룹 차원
다음은 지원되는 그룹 차원입니다. 조정이 필요하면 source.group_by를 수정하십시오
| 필드 | 기본 여부 | 설명 |
|---|---|---|
| day | 예 | 광고 노출 날짜 |
| hour | 예 | 리포트의 시간 값(최근 30일 데이터를 수집할 때만 이 필드가 존재) |
| has_idfa | 예 | 유저의 광고 ID를 가져올 수 있는지 여부. 유저가 LAT를 활성화했거나 GDPR 적용 지역에서 데이터 추적을 끈 경우 값은 0, 그렇지 않으면 1 |
| max_ad_unit | 예 | MAX 광고 이름 |
| max_ad_unit_id | 예 | MAX 광고 ID |
| max_ad_unit_test | 예 | 광고 테스트 그룹 이름 |
| network_placement | 예 | Ad Network의 Placement 이름 |
| max_placement | SDK에서 정의한 커스텀 Placement 이름 | |
| network | 예 | 광고를 표시한 Ad Network, 값은 다음을 참고(MAX Mediation Documentation) |
| package_name | 예 | 패키지명, Android의 App Package Name과 iOS의 Bundle ID (iOS) |
| platform | 예 | 플랫폼 |
| ad_format | 예 | 광고 유형: INTER, BANNER, REWARD |
| ad_unit_waterfall_name | 예 | 광고 Waterfall 이름 |
| application | 예 | 앱 이름 |
| country | 예 | 영문 두 글자 Country Code |
| custom_network_name | 예 | 커스텀 광고 Ad Network 이름 |
| device_type | 예 | 기기 유형: PHONE, TABLET |
| store_id | 홍보 App의 앱 마켓 ID, Android는 package name, iOS는 iTunes ID의 숫자 부분 |
- 지표 필드
다음은 지원되는 지표 필드입니다. 조정이 필요하면 source.metrics를 수정하십시오
| 필드 | 기본 여부 | 설명 |
|---|---|---|
| impressions | 예 | 광고 노출 수 |
| estimated_revenue | 예 | 예상 총수익(USD) |
| attempts | 예 | Ad Network의 광고 요청 시도 수(그룹 수집 필드에 network 또는 network_placement가 있을 때만 사용 가능, max_placement가 있으면 사용 불가) |
| ecpm | 예 | 예상 eCPM(USD) |
fill_rate | 예 | 광고 채움률 = 광고 응답 수 / 요청 시도 수(그룹 수집 필드에 network 또는 network_placement가 있을 때만 사용 가능, max_placement가 있으면 사용 불가) |
| responses | 예 | 광고 응답 수(그룹 수집 필드에 network 또는 network_placement가 있을 때만 사용 가능, max_placement가 있으면 사용 불가) |
| requests | 광고 요청 수(network 또는 network_placement, max_placement가 있으면 사용 불가) |
2.5 데이터 저장 규칙
기본적으로 수집한 데이터는 이벤트 형태로 AE 프로젝트에 기록됩니다:
- hour 필드가 없는 경우(즉 30일 이전 데이터) 데이터의 day 필드, 즉 데이터의 날짜를 집계 데이터의 #event_time으로 설정합니다. hour가 있는 경우 day와 hour 필드를 결합하여 집계 데이터의 #event_time으로 설정합니다
- 데이터 이벤트 이름은 -- applovin_maxreport입니다
- 나머지 필드는 모두 저장됩니다
2.6 표준화 필드
다음 이벤트 속성은 표준화 처리됩니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| max_ad_unit | te_ads_object.ad_group_name | 수익화 광고의 Unit 이름 |
| max_ad_unit_id | te_ads_object.ad_group_id | 수익화 광고의 Unit ID |
| network_placement | te_ads_object.placement | 광고 위치 |
| network | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| package_name | te_ads_object.app_id | 앱 ID |
| application | te_ads_object.app_name | 앱 이름 |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| country | te_ads_object.country | 국가/지역 코드 |
| USD 고정값 | te_ads_object.currency | 수익화 수익의 통화 |
| impressions | te_ads_object.impressions | 노출 수 |
| estimated_revenue | te_ads_object.revenue | 수익화 수익 |