myDSP RTB Integration Guidelines SRTB JSON XRTB XML GET
Related articles:
Stats
Example URL for stats:
http://[STATS_DOMAIN_GIVEN_TO_YOU]/pubstats/api/v1/[API_KEY]/rtb?date=2022-08-15_2022-08-15
The stats endpoint does not use the same domain as the RTB endpoint. Confirm which stats domain you'll be using with your account manager.
Stats timezone is UTC. API Stats are updated every hour.
Example Stats
Displayed stats are for valid revenue only; invalidated clicks will not be shown. In the near future, it will be possible to see invalidated clicks and the invalidation reasons. That will be enabled for you if you request it. As of now, there is no option to get invalidation data via API. Example stats output (prettified for this example, output will be minified):
Default (date→country_code→subid→[clicks,revenue]):
{
"2021-08-16":{
"US":{
"SUBID1":{"clicks":39,"revenue":0.51},
"SUBID2":{"clicks":45,"revenue":0.879006},
},
"CA":{
"SUBID1":{"clicks":39,"revenue":0.51},
"SUBID2":{"clicks":45,"revenue":0.879006},
}
},
"2021-08-17":{
"US":{
"SUBID1":{"clicks":11,"revenue":0.41},
"SUBID2":{"clicks":66,"revenue":0.36},
},
"CA":{
"SUBID1":{"clicks":98,"revenue":0.81},
"SUBID2":{"clicks":16,"revenue":0.099},
}
},
}
You have the option of appending "&output=[sid|date]" in order to get stats grouped by either date→subid (sid) or total values per date (date). More options + CSV outputs will be added in the future.
Example stats output with "&output=date":
{
"2021-08-16":{"clicks":49406,"revenue":417.5121415730781},
"2021-08-17":{"clicks":89789,"revenue":797.618956}
}
Example stats output with "&output=sid":
{
"2021-08-16":{"SUBID1":{"clicks":39,"revenue":0.51}},"SUBID2":{"clicks":45,"revenue":0.879006},
"2021-08-17":{"SUBID1":{"clicks":39,"revenue":0.51}},"SUBID2":{"clicks":45,"revenue":0.879006}
}
You also have the option to use nodate-sid (only shows subids without separating data by date keys) and nodate-cc (only shows countries without separating data by country code keys).
Example stats output with "&output=nodate-sid":
{
{"SUBID1":{"clicks":78,"revenue":1.02}},"SUBID2":{"clicks":90,"revenue":1.758012}
}
Example stats output with "&output=nodate-cc":
{
{"US":{"clicks":335,"revenue":6.93},"IL":{"clicks":56,"revenue":0.3156123481},"AD":{"clicks":2,"revenue":0.1457455692}
}
If there are no revenues for a specific date in your request, the date will contain an empty object like this:
{
"2021-08-16":{},
"2021-08-17":{"SUBID1":{"clicks":39,"revenue":0.51}},"SUBID2":{"clicks":45,"revenue":0.879006}
}
Example stats output with "&output=e_c":
{
"2023-06-27":{"3858rdf98h9843h":{"clicks":1,"revenue":1.0e-5},"8498496fefetwg5":{"clicks":1,"revenue":0.25}}
}
NOTE: e_c will only contain stats if you pass a value in it during a bid request. No value passed during RTB request = no entry in the stats