HTML Metrics API
/playableMetrics 엔드포인트는 HTML 광고 성과에 대한 포괄적인 분석 데이터를 제공합니다.
이 API를 사용하면 노출 수, 사용자 상호작용, 챌린지 완료율, 에러 트래킹을 포함한 에셋 수준의 메트릭을 쿼리할 수 있습니다.
Request format
HTTP GET 요청을 다음 주소로 전송하여 리포트를 요청하십시오: https://r.applovin.com/playableMetrics
Required parameters
| Parameters | Purpose |
|---|---|
api_key | 귀하의 Report Key AppLovin dashboard 우측 상단의 계정을 클릭하고 Keys를 선택하여 Report Key를 확인할 수 있습니다. |
columns | 리포트에 포함할 열의 쉼표로 구분된 목록 아래의 허용되는 열을 참조하십시오. 예: day,html_name,impressions. |
start1 | 리포트 시작일«YYYY-MM-DD» 형식의 날짜를 입력합니다. 예: 2012-10-05. |
end1 | 리포트 종료일«YYYY-MM-DD» 형식의 날짜를 입력합니다. 예: 2012-10-05. |
1이 API의 요청 가능 기간은 45일입니다. 날짜 파라미터가 최근 45일 이내인지 확인하십시오.
Optional parameters
| Parameters | Purpose |
|---|---|
format | 리포트 형식json 또는 csv를 지원합니다. 기본값: json |
day_column | 메트릭은 기본적으로 코호트 기준으로 집계됩니다. 실시간 메트릭을 가져오려면 이 값을 event_day로 설정하십시오. |
limit | 반환하고자 하는 최대 행 수. 예: 500 (결과 페이지네이션을 위해 limit과 offset을 함께 사용하십시오) |
offset | 행을 가져오기 시작할 오프셋 위치. 예: 100 (결과 페이지네이션을 위해 limit과 offset을 함께 사용하십시오) |
Available columns
General
| Column name | Contains |
|---|---|
asset_id | HTML 에셋의 고유 식별자 |
average_duration | HTML 노출의 절단 평균 시간 (초 단위) |
country | 노출이 발생한 국가 또는 지역. 가능한 값:
|
day | «YYYY-MM-DD» 형식의 리포트 날짜. 예: 2012-10-05 |
device_model | HTML이 표시된 기기 모델. 제조사별 상위 100개 모델을 포함합니다. 가능한 값: apple_promax13, samsung_sma035f, tecno_tecnokh7 |
html_name | HTML 에셋의 이름 |
impressions | 총 노출 수 |
original_url | 업로드된 HTML 파일의 URL |
os_version | 운영 체제의 메이저 버전. 가능한 값: 14, 15, 16 |
platform | HTML이 표시된 플랫폼. 가능한 값: ANDROID, IOS |
spend | 총 지출 금액 |
total_interactions | 모든 터치 동작을 포함하여 HTML과 발생한 총 사용자 상호작용 수 |
unique_interactions | 노출당 중복 제거된 HTML과의 총 사용자 상호작용 수 (모든 터치 동작 포함) |
unique_interactions_rate | impressions 대비 unique_interactions 비율 |
unique_redirects | 사용자를 앱 스토어로 리디렉션한 HTML 내의 총 클릭 수 (노출당 1회만 카운트) |
unique_redirects_rate | impressions 대비 unique_redirects 비율 |
HTML status
| Column name | Contains |
|---|---|
html_loading | HTML 로딩이 시작된 총 횟수 |
html_loaded | HTML이 성공적으로 로드된 총 횟수 |
html_displayed | HTML이 성공적으로 표시된 총 횟수 |
html_completed | HTML이 완전히 완료된 총 횟수 |
html_completion_rate | impressions 대비 html_completed 비율 |
Challenge metrics
| Column name | Contains |
|---|---|
challenge_started | HTML 내의 챌린지가 시작된 총 횟수 |
challenge_failed | 사용자가 HTML 내의 챌린지에 실패한 총 횟수 |
challenge_failed_rate | impressions 대비 challenge_failed 비율 |
challenge_retry | 사용자가 HTML 내의 챌린지를 재시도한 총 횟수 |
challenge_retry_rate | impressions 대비 challenge_retry 비율 |
challenge_solved | 사용자가 HTML 내의 챌린지를 해결한 총 횟수 |
challenge_solved_rate | impressions 대비 challenge_solved 비율 |
challenge_pass_25 | 사용자가 HTML 내 챌린지의 25%를 통과한 총 횟수 |
challenge_pass_25_rate | impressions 대비 challenge_pass_25 비율 |
challenge_pass_50 | 사용자가 HTML 내 챌린지의 50%를 통과한 총 횟수 |
challenge_pass_50_rate | impressions 대비 challenge_pass_50 비율 |
challenge_pass_75 | 사용자가 HTML 내 챌린지의 75%를 통과한 총 횟수 |
challenge_pass_75_rate | impressions 대비 challenge_pass_75 비율 |
Redirect metrics
| Column name | Contains |
|---|---|
cta_clicked | CTA 버튼이 클릭된 총 횟수 |
cta_click_rate | impressions 대비 cta_clicked 비율 |
endcard_shown | HTML 단계 이후 엔드카드가 표시된 총 횟수 |
redirect_count | HTML 페이지에서의 총 리디렉션 횟수 |
redirect_rate | impressions 대비 redirect_count 비율 |
Health metrics
| Column name | Contains |
|---|---|
black_view_error | HTML 페이지에서 발생한 총 블랙 뷰 에러 수 |
black_view_error_rate | impressions 대비 black_view_error 비율 |
rendering_error | HTML 페이지에서 발생한 총 렌더링 에러 수 |
rendering_error_rate | impressions 대비 rendering_error 비율 |
runtime_error | HTML 페이지에서 발생한 총 런타임 에러 수 |
runtime_error_rate | impressions 대비 runtime_error 비율 |
Filtering columns
모든 열을 기준으로 리포트를 필터링할 수 있습니다. 필터링을 적용하면 필터 값과 정확히 일치하는 항목을 검색합니다.
열 기준으로 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_«columnname»=«onefilter,anotherfilter,thirdfilter»
예를 들어, Android 플랫폼의 데이터만 보려면 다음 URL 파라미터를 설정하십시오: filter_platform=ANDROID
전체 열 목록은 위의 테이블을 참조하십시오.
Sorting columns
리포트 필터링과 유사한 방식으로 리포트를 정렬할 수 있습니다.
예를 들어, campaign 기준으로 리포트를 정렬하려면 다음 URL 파라미터를 추가하십시오: sort_campaign=ASC
허용되는 값은 오름차순의 경우 ASC, 내림차순의 경우 DESC입니다.
모든 정렬은 사전식 정렬(lexicographical sort)을 따릅니다.
Time zone
리포팅 API의 모든 데이터는 UTC(협정 세계시) 기준입니다.
Example request
https://r.applovin.com/playableMetrics?api_key=«your-report-key»&start=2025-10-27&end=2025-10-27&columns=day,asset_id,html_name,impressions,unique_interactions&format=json&limit=100&sort_impressions=desc
