Skip to content

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:

https://r.applovin.com/report

Example Final 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

Required Parameters

parameterpurposeusage
api_keyManagement Key. You obtain this from Account > General > Keys.api_key=«management-key»
startDatesstart=«YYYY»-«MM»-«DD»
endDatesend=«YYYY»-«MM»-«DD»
columnsColumns. See Reporting Columns below.columns=«api-columns»
formatMiscellanyformat=[csv|json]
report_typeMiscellanyreport_type=[dsp_report|dsp_latency]*

* The dsp_latency type is deprecated. Contact your AppLovin representative if you have any questions.

Optional Parameters

parameterpurposeusage
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 columndescription
ad_typeAd type: BANNER, INTER, NATIVE
bundle 
campaign_domainbid.adomain value in bid responses
countryCountry
dayDate («MM»/«DD»/«YY»)
device_typeDevice (Phone, Tablet, Other)
hour00:00–23:00
impressionsImpressions
platformPlatform (iOS/Android/Fire OS)
sizeAd Size (BANNER, MREC, NATIVE, INTER, or LEADER)
spendSpend

Response Codes

coderesponse textdescription
100HTTP_UNEXPECTED_RESPONSEReceived an unexpected HTTP response code
200HTTP_OKAYSuccessful 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
204HTTP_NO_CONTENTNo bid response
300HTTP_UNEXPECTED_REDIRECTTemporary Redirect status response code indicates that the resource requested has been temporarily moved to the URL given by the Location headers.
400HTTP_BAD_REQUESTRequest malformed
403HTTP_FORBIDDENForbidden response status code indicates that the server understands the request but refuses to authorize it.
404HTTP_NOT_FOUNDEndpoint not found or invalid
408HTTP_REQUEST_TIMEOUTTimeout above required response time (150ms)
500HTTP_INTERNAL_SERVER_ERRORAn error occurred on AppLovin’s service
502HTTP_BAD_GATEWAYBad Gateway server error response code indicates that the server, while acting as a gateway or proxy, received an invalid response from the upstream server.
503HTTP_SERVICE_UNAVAILABLEService Unavailable server error response code indicates that the server is not ready to handle the request.
2000NETWORK_ALLOCATION_ERRORNetworking error
2010NETWORK_QPS_ERRORNetworking error
2020NETWORK_SOCKET_ERRORNetworking error