DSP Reporting
DSPs see their performance on AppLovin RTB by means of the same performance metrics that AppLovin uses. You access these metrics via the AppLovin DSP Report APIs.
All AppLovin numbers are final for billing. Contact AppLovin immediately if you see discrepancies between numbers from your DSP and the AppLovin API.
Base URL
Send report requests via an HTTP GET
to the following base URL:
Example Final URL
Required Parameters
parameter | purpose | usage |
---|---|---|
api_key | Management Key. You obtain this from Account > General > Keys. | api_key=«management-key» |
start | Dates | start=«YYYY»-«MM»-«DD» |
end | Dates | end=«YYYY»-«MM»-«DD» |
columns | Columns. See Reporting Columns below. | columns=«api-columns» |
format | Miscellany | format= [csv |json ] |
report_type | Miscellany | report_type= [dsp_report |dsp_latency |
* The dsp_latency
type is deprecated.
Contact your AppLovin representative if you have any questions.
Optional Parameters
parameter | purpose | usage |
---|---|---|
filter_«x» | Filtering Columns. Replace «x» with the column name. Separate multiple filter values with commas. | filter_country=us,gb |
sort_«x» | Sorting Columns. Replace «x» with the column name. | sort_requests= [ASC |DESC ] |
Basic Reporting Columns
reporting column | description |
---|---|
ad_type | Ad type: BANNER , INTER , NATIVE |
bundle | |
campaign_domain | bid.adomain value in bid responses |
country | Country |
day | Date («MM»/«DD»/«YY») |
device_type | Device (Phone, Tablet, Other) |
hour | 00:00–23:00 |
impressions | Impressions |
platform | Platform (iOS/Android/Fire OS) |
size | Ad Size (BANNER , MREC , NATIVE , INTER , or LEADER ) |
spend | Spend |
Response Codes
code | response text | description |
---|---|---|
100 | HTTP_UNEXPECTED_RESPONSE | Received an unexpected HTTP response code |
200 | HTTP_OKAY | Successful bid response. Includes bids that were filtered for the below reasons. Use the loss notification URL with the loss reason macro (AUCTION_LOSS ) to get more granular details:
|
204 | HTTP_NO_CONTENT | No bid response |
300 | HTTP_UNEXPECTED_REDIRECT | Temporary Redirect status response code indicates that the resource requested has been temporarily moved to the URL given by the Location headers. |
400 | HTTP_BAD_REQUEST | Request malformed |
403 | HTTP_FORBIDDEN | Forbidden response status code indicates that the server understands the request but refuses to authorize it. |
404 | HTTP_NOT_FOUND | Endpoint not found or invalid |
408 | HTTP_REQUEST_TIMEOUT | Timeout above required response time (150ms) |
500 | HTTP_INTERNAL_SERVER_ERROR | An error occurred on AppLovin’s service |
502 | HTTP_BAD_GATEWAY | Bad Gateway server error response code indicates that the server, while acting as a gateway or proxy, received an invalid response from the upstream server. |
503 | HTTP_SERVICE_UNAVAILABLE | Service Unavailable server error response code indicates that the server is not ready to handle the request. |
2000 | NETWORK_ALLOCATION_ERROR | Networking error |
2010 | NETWORK_QPS_ERROR | Networking error |
2020 | NETWORK_SOCKET_ERROR | Networking error |