Reporting API
이 Reporting API를 사용하여 JSON 또는 CSV 형식의 집계된 캠페인 데이터를 가져옵니다.
Request format
다음 베이스 URL로 HTTP GET 요청을 전송하여 리포트 요청을 생성합니다.
https://r.applovin.com/report
Required parameters
| Parameters | Purpose |
|---|---|
api_key | 귀하의 Report Key 대시보드 우측 상단에서 귀하의 계정을 클릭하고 Keys를 선택하여 AppLovin dashboard에서 Report Key를 찾을 수 있습니다. |
start1 | 리포트 시작일«YYYY-MM-DD» 형식의 날짜 또는 Unix 타임스탬프를 허용합니다. 예: 2012-10-05 또는 1336608000. |
end1 | 리포트 종료일«YYYY-MM-DD» 형식의 날짜, Unix 타임스탬프 또는 now를 허용합니다. 예: 2012-10-05 또는 1336608000 또는 now. |
format | 리포트 형식json 또는 csv를 허용합니다. 아래의 요청 형식 세부 정보를 참조하십시오. |
columns | 리포트에 포함할 열의 쉼표로 구분된 목록 아래의 허용되는 열을 참조하십시오. 예: day,campaign. |
report_type | advertiser (필수) |
1 이 API의 요청 기간은 90일입니다. 날짜 파라미터가 최근 90일 이내인지 확인하십시오.
Optional parameters
| Parameters | Purpose |
|---|---|
day_column | 지표는 기본적으로 실시간입니다. 코호트 하에서 지표를 가져오려면 이를 day로 설정하십시오 (지표는 노출 시점으로 소급 적용됩니다). |
limit | 반환되는 행 수의 제한. 예: 500 |
offset | 행을 가져오기 시작할 오프셋. 예: 100 |
having | 숫자 값에 대한 복잡한 필터링을 허용합니다. 이 파라미터는 숫자 열, 비교 연산자 및 논리 연산자의 URL 인코딩된 값을 허용합니다. 예: impressions%20%3E%200%20AND%20cost%20%3E%200 (“impressions > 0 AND cost > 0”).참고: 이 기능은 응답 속도를 늦추고 타임아웃 가능성을 높입니다. |
not_zero | 모든 수치 지표의 값이 0인 결과를 필터링하려면 이를 1로 설정하십시오. |
Recommended columns
| Column name | Contains |
|---|---|
campaign | 캠페인 이름 |
campaign_id_external | 캠페인에 대한 고유 참조 값 캠페인 이름이 변경되어도 이 값은 변경되지 않습니다. {CAMPAIGN_ID} 클릭 매크로와 동일한 값입니다. |
cost | 광고주 지출액 |
country | 두 자리 국가 코드 |
creative_set | 크리에이티브 세트 이름 |
creative_set_id | 크리에이티브 세트 ID. 크리에이티브 세트 이름이 변경되어도 이 값은 변경되지 않습니다. |
day | 리포팅 데이터의 날짜 |
hour | 리포팅 데이터의 시간 (지난 30일 동안의 데이터만 제공됨) |
Optional columns
| Column name | Contains |
|---|---|
average_cpc | 평균 클릭당 비용 (CPC) |
campaign_bid_goal | CPP 및 CPE 캠페인의 달러($) 값으로 표시된 캠페인 입찰 목표. 이 열을 요청할 때는 campaign 열도 함께 요청해야 합니다. |
campaign_type | 캠페인 최적화 유형 (CPP, CPE 또는 ROAS) |
audience_strategy | 캠페인 오디언스 최적화 전략 (universal, prospecting 또는 discovery) |
sales_«x»1 | 특정 기간 동안의 매출 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d 중 하나) |
chka_usd_«x»1 | 특정 기간 동안 발생한 총 기여 체크아웃 매출 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d 중 하나) |
clicks | 클릭 수 |
cpp_«x»1 | 특정 기간 동안의 구매당 비용 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d 중 하나) |
ctr | 클릭 수 ÷ 노출 수 |
custom_page_id | 특정 랜딩 페이지 |
impressions | 노출 수 |
optimization_day_target | 캠페인 타겟으로 선택한 최적화 일수 (예: 0일 또는 7일) |
placement_type | INTER 또는 REWARDED_INTER |
platform | android, ios, fireos 또는 tvos |
roas_«x»1 | 특정 기간 동안의 총 ROAS («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d 중 하나) |
sales | 기여된 매출 이벤트 수 |
1기간은 노출 시점부터 롤링 윈도우로 지정됩니다. 0d는 노출 시점 이후 24시간 이내의 이벤트를 의미하며, 1d는 48시간, 2d는 72시간 등을 의미합니다.
New customer data columns
| Column name | Contains |
|---|---|
nc_d0_checkouts | 노출 후 24시간 이내에 신규 고객이 수행한 체크아웃 수. |
nc_d0_checkout_rev | 노출 후 24시간 이내에 측정된 신규 고객의 총 매출. |
nc_d0_cpp | 지출액을 신규 고객 D0 체크아웃 수로 나눈 값. |
nc_d0_roas | 신규 고객 D0 체크아웃 매출을 지출액으로 나눈 값. |
nc_percent_d0_checkouts | 신규 고객에 의해 발생한 D0 체크아웃 비율. |
nc_percent_d0_checkout_rev | 신규 고객에 의해 발생한 D0 체크아웃 매출 비율. |
nc_d7_checkouts | 노출 후 192시간 이내에 신규 고객이 수행한 체크아웃 수. |
nc_d7_checkout_rev | 노출 후 192시간 이내에 측정된 신규 고객의 총 매출. |
nc_d7_cpp | 지출액을 신규 고객 D7 체크아웃 수로 나눈 값. |
nc_d7_roas | 신규 고객 D7 체크아웃 매출을 지출액으로 나눈 값. |
nc_percent_d7_checkouts | 신규 고객에 의해 발생한 D7 체크아웃 비율. |
nc_percent_d7_checkout_rev | 신규 고객에 의해 발생한 D7 체크아웃 매출 비율. |
new_visitor_rate | 귀하의 웹사이트 방문 중 신규 방문자의 비율. |
CPE columns
| Column name | Contains |
|---|---|
cost_per_target_event_0d | 지출액을 노출 후 24시간 이내에 발생한 타겟 이벤트 수로 나눈 값. |
target_event | 캠페인이 최적화하고자 하는 이벤트의 이름. |
target_event_count_0d | 노출 후 24시간 이내에 고객에 의해 트리거된 타겟 이벤트 수. |
Filtering columns
어떤 열로든 리포트를 필터링할 수 있습니다. 필터링을 적용하면 필터 중 하나와 정확히 일치하는 항목을 검색합니다.
열 기준으로 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_columnname=«onefilter,anotherfilter,thirdfilter»
예를 들어 Android 플랫폼의 데이터만 보려면 다음 URL 파라미터를 설정하십시오: filter_platform=Android
모든 열 목록은 위의 표를 참조하십시오.
일부 열은 filter_not_columnname=«onefilter,anotherfilter»를 통해 부정 필터를 지원합니다.
또한 custom_page_id 열은 filter_null_custom_page_id, filter_blank_custom_page_id, filter_not_null_custom_page_id 및 filter_not_blank_custom_page_id 옵션을 지원합니다.
이러한 옵션은 값을 요구하지 않습니다. 예: …&filter_not_null_custom_page_id=&filter_not_blank_custom_page_id=&…
Sorting columns
리포트를 필터링하는 것과 유사한 방식으로 리포트를 정렬합니다.
예를 들어 campaign 기준으로 리포트를 정렬하려면 다음 URL 파라미터를 추가하십시오: sort_campaign=ASC
허용되는 값은 오름차순의 경우 ASC, 내림차순의 경우 DESC입니다.
모든 정렬은 사전식 정렬(lexicographical sort)입니다.
Report formats
JSON 또는 CSV의 두 가지 형식으로 리포트를 요청할 수 있습니다.
Time zone
reporting API의 모든 데이터는 UTC (협정 세계시) 기준입니다.
Example request
https://r.applovin.com/report?api_key=«your-report-key»&start=2024-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,cost,sales&format=json&report_type=advertiser
