Asset Reporting API
이 Reporting API를 사용하여 JSON 또는 CSV 형식으로 집계된 에셋 수준의 캠페인 데이터를 검색할 수 있습니다.
어제 데이터는 UTC 기준 오전 6시 이후에 안정화됩니다.
Request format
다음 기본 URL 중 하나로 HTTP GET 요청을 전송하여 리포트 요청을 수행합니다.
https://r.applovin.com/assetReport(시간 범위 기준)https://r.applovin.com/assetAnalyticsReport(날짜 기준)
Required time parameters
/assetReport
| Parameters | Purpose |
|---|---|
range | 이 리포트의 시간 범위입니다. 유효한 값: yesterday, last_7d, last_month. |
/assetAnalyticsReport
| Parameters | Purpose |
|---|---|
start1 | 리포트의 시작 날짜입니다. «YYYY-MM-DD» 형식의 날짜를 허용합니다. 예: 2012-10-05. |
end1 | 리포트의 종료 날짜입니다. «YYYY-MM-DD» 형식의 날짜를 허용합니다. 예: 2012-10-05. |
1이 API의 요청 기간은 45일입니다. 날짜 파라미터가 최근 45일 이내인지 확인하십시오.
Required parameters
| Parameters | Purpose |
|---|---|
api_key | 귀하의 Report Key 대시보드 우측 상단에서 계정을 클릭하고 Keys를 선택하여 AppLovin dashboard에서 Report Key를 찾을 수 있습니다. |
columns | 리포트에 포함할 열의 쉼표로 구분된 목록입니다. 아래의 사용 가능한 열을 참조하십시오. 예: asset_id,impressions. |
Optional parameters
| Parameters | Purpose |
|---|---|
format | 리포트 형식입니다.json 또는 csv를 허용합니다. 기본값은 json입니다. |
limit | 반환하려는 행 수의 제한입니다. 예: 500 (결과를 페이지네이션하려면 limit와 offset을 사용하십시오) |
offset | 행을 가져오기 시작할 오프셋입니다. 예: 100 (결과를 페이지네이션하려면 limit와 offset을 사용하십시오) |
Available columns
| Column name | Contains |
|---|---|
asset_id | Asset ID |
asset_name | Asset 이름 |
asset_url | 처리 전 원본 asset의 URL |
campaign | 캠페인 이름 |
campaign_id | 캠페인의 고유 참조 ID입니다. Reporting API의 campaign_id_external과 일치합니다. |
campaign_package_name | 캠페인 패키지 이름 |
clicks | 클릭 수 |
cost | 광고주 지출액 |
creative_set | 크리에이티브 세트 이름 |
creative_set_id | 크리에이티브 세트 ID입니다. 크리에이티브 세트 이름이 변경되어도 이 ID는 변경되지 않습니다. |
ctr | 클릭 수 ÷ 노출 수 |
impressions | 노출 수 |
Filtering columns
asset_id, asset_name, campaign, campaign_id, campaign_package_name, creative_set 및 creative_set_id를 기준으로 리포트를 필터링할 수 있습니다.
필터링을 수행하면 필터 중 하나와 정확히 일치하는 항목을 검색합니다.
예를 들어 ID가 12345인 특정 asset의 데이터만 보려면 다음과 같이 URL 파라미터를 설정하십시오: asset_id=12345
asset_name으로 필터링할 때는 이름을 이중 URL 인코딩해야 합니다 (단, 여러 값을 보낼 때 쉼표는 인코딩하지 마십시오).
예를 들어 asset 이름 html+3 및 video(25)로 필터링하려면 filter_asset_name=html%252B3,video%252825%2529로 설정하십시오.
- 원본 필터:
html+3,video(25) - 1차 URL 인코딩:
html%2B3,video%2825%29(쉼표,문자는 인코딩하지 않고+,(,)문자만 URL 인코딩함) - 이중 인코딩:
html%252B3,video%252825%2529(1차 URL 인코딩에서 생성된%문자를 추가로 인코딩함)
열 기준으로 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_«columnname»=«onefilter,anotherfilter,thirdfilter»
filter_not_«columnname»=«onefilter,anotherfilter»를 통해 부정 필터를 사용할 수도 있습니다.
Filtering metrics
greater_than 또는 less_than 필터를 통해 impressions 및 cost와 같은 수치 메트릭을 필터링할 수도 있습니다.
메트릭이 특정 숫자보다 크도록 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_greater_than_«columnname»=«number»
메트릭이 특정 숫자보다 작도록 필터링하려면 다음 URL 파라미터를 추가하십시오: filter_less_than_«columnname»=«number»
예를 들어 노출 수가 100보다 큰 asset의 데이터만 보려면 다음 URL 파라미터를 설정하십시오: filter_greater_than_impressions=100
쿼리 파라미터 not_zero=1을 추가하여 모든 0 값을 필터링할 수도 있습니다.
Sorting columns
리포트를 필터링하는 것과 유사한 방식으로 리포트를 정렬합니다.
예를 들어 impressions 기준으로 리포트를 정렬하려면 다음 URL 파라미터를 추가하십시오: sort_impressions=ASC
허용되는 값은 오름차순의 경우 ASC, 내림차순의 경우 DESC입니다.
모든 정렬은 사전식 정렬(lexicographical sort)입니다.
Example request
https://r.applovin.com/assetReport?api_key=«your-report-key»&range=yesterday&columns=asset_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC
