Reporting API
이 Reporting API를 사용하여 JSON 또는 CSV 형식의 집계된 캠페인 데이터를 가져옵니다.
Request format
다음 베이스 URL로 HTTP GET 요청을 전송하여 리포트를 요청합니다: https://r.applovin.com/report
Required parameters
| Parameters | Purpose |
|---|---|
api_key | 귀하의 Report Key AppLovin dashboard 우측 상단에서 귀하의 계정을 클릭하고 Keys를 선택하여 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 | API가 publisher 또는 advertiser 데이터로 응답하도록 지정이 매개변수를 생략하면 API는 기본적으로 report_type=publisher로 설정됩니다. |
1이 API의 요청 기간은 45일입니다. 날짜 매개변수가 최근 45일 이내인지 확인하십시오.
Optional parameters
| Parameters | Purpose |
|---|---|
day_column | 지표는 기본적으로 실시간입니다. 코호트 하위 지표를 가져오려면 이 값을 day로 설정하십시오. |
limit | 반환하려는 최대 행 수. 예: 500 (결과를 페이지네이션하려면 limit 및 offset을 사용하십시오) |
offset | 행을 가져오기 시작할 오프셋. 예: 100 (결과를 페이지네이션하려면 limit 및 offset을 사용하십시오) |
having | 숫자 값을 기준으로 결과를 필터링할 수 있습니다. 이 매개변수는 숫자 열, 비교 연산자 및 논리 연산자의 URL 인코딩된 값을 허용합니다. 예: impressions%20%3E%200%20AND%20revenue%20%3E%200 (“impressions > 0 AND revenue > 0”).참고: 이 옵션은 응답 속도를 늦추고 타임아웃 발생 가능성을 높입니다. |
not_zero | 모든 수치 지표의 값이 0인 결과를 필터링하여 제외하려면 이 값을 1로 설정하십시오. |
Allowed publisher columns
| Column name | Contains |
|---|---|
ad_type | APPOPEN, GRAPHIC, MRAID, PLAY, REWARD 또는 VIDEO |
application | 앱 이름 |
application_is_hidden | 대시보드에서 앱이 숨겨져 있는지 여부 |
bidding_integration | AppLovin이 비딩을 진행하는 mediation 제공업체 (MAX mediation의 경우 MAX, AdMob Mediation Open Bidding 또는 Google Ad Manager/GAM의 경우 Google, 비비딩/존 연동의 경우 None) |
clicks | 클릭 수 |
country | 두 자리 국가 코드 |
ctr | 클릭 수 ÷ impression 수 |
day | 리포팅 데이터 날짜 |
device_type | phone, tablet 또는 other |
ecpm | 1,000회 impression당 수익 |
hour | 리포팅 데이터 시간 (지난 30일 동안만 사용 가능) |
impressions | impression 수 |
package_name | 앱의 패키지 이름 또는 bundle ID |
placement_type | APP_OPEN, BANNER, INTER, LEADER, MREC, NATIVE 또는 REWARDED_INTER |
platform | android, fireos, ios |
revenue | 발생한 수익 |
size | 광고 크기 (BANNER, INTER, LEADER, MREC 또는 NATIVE) |
store_id | iOS의 경우 iTunes ID의 숫자 부분, Android의 경우 package_name.AppLovin이 iTunes ID를 알지 못하는 경우 대신 Bundle ID가 사용됨 |
zone | 존 이름 (계정에서 사용 가능한 경우) |
zone_id | 존 ID (계정에서 사용 가능한 경우) 존을 사용하려면 담당 어카운트 매니저에게 문의하십시오. |
Allowed advertiser columns
| Column name | Contains |
|---|---|
ad | 광고 이름 |
ad_creative_type | GRAPHIC, PLAYABLE, VIDEO, VIDEO_GRAPHIC 또는 VIDEO_PLAYABLE |
ad_rev_«x» | 특정 기간 동안의 광고 수익 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d 또는 1y 중 하나) |
ad_roas_«x» | 특정 기간 동안의 광고비 대비 매출액(ROAS) («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d 또는 1y 중 하나) |
ad_type | APPOPEN, GRAPHIC, PLAY, REWARD 또는 VIDEO |
app_id_external | 해시된 애플리케이션 ID (일반적으로 “사이트 ID”라고 함) |
application | 소스 애플리케이션 이름 |
average_cpa | 전환당 평균 비용 |
average_cpc | 클릭당 평균 비용 |
bidding_and_billing_method | 비딩 전략 (AUTO_BIDDING_WITH_CPM_BILLING, CAPPED_GOAL_BIDDING_WITH_CPM_BILLING, FIXED_GOAL_BIDDING_WITH_CPI_BILLING 또는 FIXED_GOAL_BIDDING_WITH_CPM_BILLING 중 하나) |
campaign | 캠페인 이름 |
campaign_ad_type | 사용자 획득(UA)의 경우 ua, 리타게팅의 경우 rt |
campaign_bid_goal | CPP 및 CPE 캠페인의 캠페인 비딩 목표 달러 값 ($). 이 열을 요청할 때는 campaign 열도 함께 요청해야 합니다. |
campaign_id_external | 캠페인의 고유 참조 값. 캠페인 이름이 변경되어도 이 값은 변경되지 않습니다. {CAMPAIGN_ID} 클릭 매크로와 동일한 값입니다. |
campaign_package_name | 홍보 대상 앱의 패키지 이름 또는 Bundle ID |
campaign_roas_goal | IAP ROAS, Ad ROAS 및 ROAS 캠페인의 광고비 대비 매출액(ROAS) 목표 백분율 값 (%). 이 열을 요청할 때는 campaign 열도 함께 요청해야 합니다. |
campaign_store_id | iOS의 경우 홍보 대상 앱의 iTunes ID 숫자 부분, 그렇지 않은 경우 camaign_package_name |
campaign_type | 캠페인 최적화 유형 (CPP, CPE, ad ROAS, IAP ROAS 또는 ROAS) |
clicks | 클릭 수 |
conversions | 전환 수 (설치 수) |
conversion_rate | 전환 수 ÷ impression 수 |
cost | 광고주 지출액 |
cost_per_target_event_«x» | 특정 기간 동안의 목표 이벤트당 비용 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d 또는 1y 중 하나) |
country | 두 자리 국가 코드 |
cpp_«x» | 특정 기간 동안의 구매당 비용 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d 또는 1y 중 하나) |
creative_set | 크리에이티브 세트 이름 |
creative_set_id | 크리에이티브 세트 ID. 크리에이티브 세트 이름이 변경되어도 이 값은 변경되지 않습니다. |
ctr | 클릭 수 ÷ impression 수 |
custom_page_id | 크리에이티브 세트와 연결된 iOS 맞춤 제품 페이지 또는 Android 스토어 등록정보 |
day | 리포팅 데이터 날짜 |
device_type | phone, tablet 또는 other |
external_placement_id | 암호화된 애플리케이션 ID |
optimization_day_target | 캠페인 타겟팅을 위해 선택한 최적화 일수 (예: 0일 또는 7일) |
placement_type | APP_OPEN, BANNER, CTV, INTER, LEADER, MREC, NATIVE 또는 REWARDED_INTER |
platform | android, fireos, ios 또는 tvos |
ret_«x» | 특정 기간 동안의 잔존율 («x»는 1d, 3d, 7d, 14d 또는 28d 중 하나) |
roas_«x» | 특정 기간 동안의 총 ROAS («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d 또는 1y 중 하나) |
sales | 어트리뷰션된 매출 이벤트 수 (수익 포스트백 필요) |
sales_«x» | 특정 기간 동안의 매출 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d 또는 1y 중 하나) |
size | 광고 크기 (BANNER, INTER, LEADER, MREC, NATIVE 또는 PRELOAD) |
target_event | 캠페인이 타겟팅하는 맞춤 이벤트 (CPE 캠페인에만 적용됨) |
target_event_count | 고유 목표 이벤트 수 |
target_event_count_«x» | 특정 기간 동안의 고유 목표 이벤트 수 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 30d, 90d 또는 1y 중 하나) |
total_rev_«x» | 특정 기간 동안의 총 수익 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d 또는 1y 중 하나) |
traffic_source | AppLovin 또는 익스체인지 이름 |
unique_purchasers_«x» | 특정 기간 동안의 고유 구매자 수 («x»는 0d, 1d, 2d, 3d, 7d, 14d, 28d, 30d, 90d 또는 1y 중 하나) |
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 requests
광고주 요청 예시:
https://r.applovin.com/report?api_key=«your-report-key»&start=2015-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,conversions,conversion_rate,app_id_external,cost,sales&format=json&report_type=advertiser
퍼블리셔 요청 예시:
https://r.applovin.com/report?api_key=«your-report-key»&start=2016-07-01&end=2016-07-07&columns=day%2Cplatform%2Ccountry%2Capplication%2Cpackage_name%2Csize%2Cad_type%2Cimpressions%2Cclicks%2Crevenue,device_type&having=impressions%20%3E%200%20AND%20revenue%20%3E%200&format=csv
