DSPs see their performance on AppLovin RTB in terms 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 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 find this in Account > General > Keys. | api_key=«management-key» |
start | Dates | start=«YYYY»-«MM»-«DD» |
end | Dates | end=«YYYY»-«MM»-«DD» |
columns | Columns. See Basic reporting columns below. | columns=«api-columns» |
format | Miscellany | format=[csv|json] |
report_type | Miscellany | report_type=[dsp_report|dsp_latency]1 |
1 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 ) |
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:- invalid native markup
- invalid VAST
- bid with a blocked category
- bid with a blocked ad domain
- bid with a blocked package
|
| 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 (150 ms) |
| 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. |