DSP 리포팅
DSP는 AppLovin RTB에서의 성과를 AppLovin이 사용하는 것과 동일한 성과 메트릭 기준으로 확인할 수 있습니다. 이러한 메트릭은 AppLovin DSP Report API를 통해 액세스할 수 있습니다.
모든 AppLovin 수치는 청구를 위한 최종 수치입니다. 귀사의 DSP 수치와 AppLovin API 수치 간에 불일치가 발생하는 경우 AppLovin에 문의하십시오.
Base URL
다음 base URL로 HTTP GET 요청을 보내 리포트를 요청하십시오.
https://r.applovin.com/report
최종 URL 예시
https://r.applovin.com/report?api_key=«api-key»&start=2017-05-01&end=2017-05-01&report_type=dsp_report&columns=platform,country,impressions,spend&sort_impressions=DESC&limit=100&format=csv
필수 파라미터
| 파라미터 | 용도 | 사용법 |
|---|---|---|
api_key | Management Key. Account > General > Keys에서 확인할 수 있습니다. | api_key=«management-key» |
start | 날짜 | start=«YYYY»-«MM»-«DD» |
end | 날짜 | end=«YYYY»-«MM»-«DD» |
columns | 열. 아래의 기본 리포팅 열을 참조하십시오. | columns=«api-columns» |
format | 기타 | format=[csv|json] |
report_type | 기타 | report_type=[dsp_report|dsp_latency |
1 dsp_latency 유형은 지원 중단(deprecated)되었습니다.
문의 사항이 있으시면 AppLovin 담당자에게 연락해 주십시오.
선택적 파라미터
| 파라미터 | 용도 | 사용법 |
|---|---|---|
filter_«x» | 필터링 열. «x»를 열 이름으로 대체하십시오. 여러 필터 값은 쉼표로 구분합니다. | filter_country=us,gb |
sort_«x» | 정렬 열. «x»를 열 이름으로 대체하십시오. | sort_requests=[ASC|DESC] |
기본 리포팅 열
| 리포팅 열 | 설명 |
|---|---|
ad_type | 광고 유형: BANNER, INTER, NATIVE |
bundle | |
campaign_domain | 입찰 응답의 bid.adomain 값 |
country | 국가 |
day | 날짜 («MM»/«DD»/«YY») |
device_type | 디바이스 (Phone, Tablet, Other) |
hour | 00:00–23:00 |
impressions | 노출 수 (impressions) |
platform | 플랫폼 (iOS/Android/Fire OS) |
size | 광고 크기 (BANNER, MREC, NATIVE, INTER 또는 LEADER) |
spend | 지출액 (spend) |
응답 코드
| 코드 | 응답 텍스트 | 설명 |
|---|---|---|
| 100 | HTTP_UNEXPECTED_RESPONSE | 예기치 않은 HTTP 응답 코드를 수신함 |
| 200 | HTTP_OKAY | 성공적인 입찰 응답. 아래의 이유로 필터링된 입찰이 포함됩니다. 더 자세한 세부 정보를 얻으려면 손실 사유 매크로(AUCTION_LOSS)가 포함된 손실 알림 URL을 사용하십시오:
|
| 204 | HTTP_NO_CONTENT | 입찰 응답 없음 |
| 300 | HTTP_UNEXPECTED_REDIRECT | Temporary Redirect 상태 응답 코드는 요청된 리소스가 Location 헤더에 의해 제공된 URL로 임시 이동되었음을 나타냅니다. |
| 400 | HTTP_BAD_REQUEST | 잘못된 형식의 요청 |
| 403 | HTTP_FORBIDDEN | Forbidden 응답 상태 코드는 서버가 요청을 이해했으나 승인을 거부함을 나타냅니다. |
| 404 | HTTP_NOT_FOUND | 엔드포인트를 찾을 수 없거나 유효하지 않음 |
| 408 | HTTP_REQUEST_TIMEOUT | 요구되는 응답 시간(150 ms)을 초과하여 타임아웃 발생 |
| 500 | HTTP_INTERNAL_SERVER_ERROR | AppLovin 서비스에서 오류가 발생함 |
| 502 | HTTP_BAD_GATEWAY | Bad Gateway 서버 에러 응답 코드는 게이트웨이 또는 프록시 역할을 하는 서버가 업스트림 서버로부터 유효하지 않은 응답을 받았음을 나타냅니다. |
| 503 | HTTP_SERVICE_UNAVAILABLE | Service Unavailable 서버 에러 응답 코드는 서버가 요청을 처리할 준비가 되지 않았음을 나타냅니다. |
| 2000 | NETWORK_ALLOCATION_ERROR | 네트워킹 오류 |
| 2010 | NETWORK_QPS_ERROR | 네트워킹 오류 |
| 2020 | NETWORK_SOCKET_ERROR | 네트워킹 오류 |
