# AppLovin Revenue Reporting API

::: Tip

주의. 플랫폼 데이터 통합을 통해 생성된 데이터는 클러스터의 데이터 소비량으로 계산됨을 유의하십시오.

:::

# 개요

API 이름	통합 유형	데이터 세분화	어트리뷰션	비용	수익	노출	클릭	전환
Revenue Reporting API	API	집계			✅	✅

AppLovin은 Max 수익의 집계 지표 API인 Revenue Reporting API (opens new window)를 제공합니다.

AppLovin의 백엔드에 로그인하고, 리포트 키를 획득합니다.
TE의 백엔드에 로그인하여, 서드파티 통합으로 진행한 후, AppLovin Revenue Reporting API의 플랜을 추가하고, 관련 설정을 완료합니다.
TE 시스템이 데이터를 정상적으로 수신하고, 리포트 구축이 완료되었는지 확인하세요.

AppLovin의 백엔드에 로그인한 후, 'Account' - 'Key'에서 리포트 키를 획득하세요. 이 키는 잘 보관해야 합니다.

리포트 키를 획득한 후, TE 시스템에 로그인하여, '서드파티' 모듈에서 새 플랜의 설정을 완료할 수 있습니다. 아래는 AppLovin Revenue Reporting API의 설정 화면입니다. 이 장의 내용에 따라 플랜을 생성하세요:

[설정] 버튼을 클릭하고, 팝업 내에서 얻은 인증 정보를 입력해 주세요.

[동기화] 모듈에서, TE 시스템이 AppLovin Revenue Reporting API 데이터를 정기적으로 수집하도록 설정할 수 있습니다. 특정 시간대별로 혹은 매시간처럼, 데이터를 일정 기간마다 수집할 수 있습니다.

[이벤트 테이블에]을 활성화하면, 전송된 데이터는 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터의 저장을 권장합니다.

데이터의 수집 세부 설정을 통합 구성 모듈에서 제어할 수 있습니다. 이에는 데이터의 시간 집계 세부정도, 수집할 지표 필드와 차원, 그리고 이벤트 이름 등이 포함됩니다.

통합 구성의 내용은 JSON 형식이며, 아래의 내용에 따라 커스텀 설정이 가능합니다:

모듈	이름	의미
sink_event	event_name	저장 후의 이벤트 이름은, 커스텀할 수 있습니다.
source	metrics	데이터 내의 지표, 리스트 타입, 다른 레벨에서 지원되는 metrics가 다르므로, 입력 시 주의가 필요합니다.
source	group_by	데이터의 그룹화, 리스트 타입, 다른 레벨에서의 지원에는 다른 group_by가 필요합니다. 입력 시 주의해 주세요.

- 그룹 세분성

아래는 source.group_by를 변경함으로써 지원되는 그룹 분류의 세분성입니다.

필드	기본값	설명
day	yes	광고 인상의 날짜
hour	yes	리포트의 시간 값(최근 30일간만 존재하는 경우)
has_idfa	yes	유저의 광고 ID를 얻을 수 있나요? 유저가 LAT를 활성화하거나 GDPR 적용 지역에서 데이터 추적을 비활성화한 경우, 이 값은 0이 됩니다. 그 외의 경우는 1입니다.
max_ad_unit	yes	MAX 광고 명
max_ad_unit_id	yes	MAX 광고 ID
max_ad_unit_test	yes	광고 테스트 그룹의 이름
network_placement	yes	Ad Network의 Placement 이름
max_placement		SDK에서 커스텀된 Placement 이름
network	yes	광고 노출의 Ad Network, 값은 참조용(MAX Mediation Documentation (applovin.com))
package_name	yes	패키지 명, App Package Name과 iOS 앱의 Bundle ID (iOS)
platform	yes	플랫폼
ad_format	yes	광고 유형：`INTER`, `BANNER`, `REWARD`
ad_unit_waterfall_name	yes	광고 Waterfall의 이름
application	yes	앱 명
country	yes	Country Code
custom_network_name	yes	커스텀 광고 Ad Network의 이름
device_type	yes	디바이스 유형: `PHONE`, `TABLET`
store_id		Android는 패키지 명, iOS는 iTunes ID의 숫자 부분입니다

- 대응 지표

아래는 지원되는 지표 필드입니다. 조정이 필요한 경우는 source.metrics를 변경해 주세요.

필드	기본값	설명
impressions	yes	광고 인상
estimated_revenue	yes	예상 총 수익(달러)
attempts	yes	Ad Network의 광고 시도 횟수(네트워크 또는 network_placement 필드가 존재하는 경우에만 사용 가능하며, max_placement가 존재하는 경우는 사용할 수 없습니다)
ecpm	yes	예상 eCPM(달러)
fill_rate	yes	광고 fill률 = 광고 응답 수 / 요청 수(그룹 내에 network 또는 network_placement가 존재하는 경우에만 사용 가능하며, max_placement가 존재하는 경우는 사용할 수 없습니다)
responses	yes	광고 응답 수(network 또는 network_placement 필드가 그룹 내에서 획득 가능한 경우에만 사용 가능하며, max_placement가 존재하는 경우는 사용할 수 없습니다)
requests		광고 요청 수(네트워크 또는 network_placement, max_placement가 존재하는 경우는 사용할 수 없습니다)

기본적으로, 획득한 데이터는 이벤트 형식으로 TE 프로젝트에 기록됩니다.

'hour' 필드가 존재하지 않는 경우(즉, 30일 전 데이터), 데이터 내의 'day' 필드를 사용합니다. 이것이 데이터의 날짜이며, AGGREGATE 데이터의 '#event_time'으로 설정됩니다. 'hour' 필드가 존재하는 경우, 'day'와 'hour' 필드를 결합하여 AGGREGATE 데이터의 '#event_time'으로 설정됩니다.
데이터 이벤트 이름은 '-- applovin_maxreport'입니다.
나머지 필드는 모두 저장됩니다.

아래의 이벤트 속성은 표준화 처리됩니다.