Wiki
Clone wikimobile.mng-ads.com-mngperf / dispatcher-api
SDK Tracking API
Quick Reference
All API access is over HTTPS, and accessed via the https://xxx.com domain (ask to your Madvertise contact).
Request Format
For POST requests, the request body must be JSON, with the Content-Type header set to application/json.
Response format
The response format for all requests is a JSON object.
Whether a request succeeded is indicated by the HTTP status code. A 2xx status code indicates success, whereas a 4xx status code indicates failure.
Helpful Tools
|json_reformat formats your output nicely without reordering the fields.
POST /auth-reporting : Authentication Service
see auth-reporting
breakdowns list
Optionally, use one of the following options in the breakdowns param to specify which metric.
breakdown | comment | Default? |
---|---|---|
DAILY | Provides a breakdown by day (can't be combined with HOURLY, RANGE and DAILY) | No |
HOURLY | Provides a breakdown by hour (can't be combined with MONTHLY, RANGE and DAILY) | No |
MONTHLY | Provides a breakdown by Month (can't be combined with HOURLY, RANGE and DAILY) | No |
RANGE | Provides a breakdown according since and until dates (can't be combined with HOURLY, MONTHLY and DAILY) | No |
APPCOUNTRY | Provides a breakdown by country (FR, IT, DE), not end-user country but country of Madvertise Office | |
PUBLISHER | Provides a breakdown by Publisher | No |
APP | Provides a breakdown by App | No |
OS | Provides a breakdown by Os (iOS / Android) | No |
SDKVERSION | Provides a breakdown by SDK version (v2.1, v2.8, ....) | No |
POST /mediation-reporting : Publisher Reporting Service
Use the token returned by auth-reporting service when making calls to
Parameters
Parameter name | Required? | Format | Description |
---|---|---|---|
since | Yes | europe/paris unix timestamp | e.g 1417392000 |
until | Yes | europe/paris unix timestamp | e.g 1420070399 |
breakdowns | No | array of string | see [breakdowns-list section], e.g breakdowns[0]=HOURLY&breakdowns[1]=APP |
publisherId | no | array of publishers IDs | For admin only Filter reporting on specific publishers e.g publisherId[0]=1&publisherId[1]=2 |
appId | no | array of apps IDs | Filter reporting on specific apps e.g appId[0]=1&appId[1]=2 |
os | no | Array of os (iOS / Android) | e.g os[0]=iOS&os[1]=Android |
sdkVersion | no | Filter reporting on a specific Ad networks | e.g sdkVersion[0]=v2.8 |
countryCode | no | (FR, IT, DE), not end-user country but country of Madvertise Office | e.g countryCode[0]=FR |
Output
#!json { "data": [ { "publisherId": "15", "appCountry": "FR", "publisherName": "FR_DEMO", "appName": "FR_DEMO_MNG_ADS_IOS", "appId": "3180317", "sdkVersion": "v2.6", "osName": "iOS", "sumEventCount": 1, "uniqueUser": 1.0002442201269 }, { "publisherId": "15", "appCountry": "FR", "publisherName": "FR_DEMO", "appName": "FR_DEMO_MNG_ADS_ANDROID", "appId": "5180317", "sdkVersion": "v2.5.3", "osName": "Android", "sumEventCount": 4, "uniqueUser": 1.0002442201269 } ], "summary": { "since": "2017-09-09T17:59:15+0200", "until": "2017-09-10T17:59:15+0200", "breakdowns": [ "DAILY", "PUBLISHER", "APP", "SDKVERSION", "COUNTRY", "OS" ], "timezone": "europe/paris" } }
Example
#!curl curl -H 'Authorization: 49440ccdbc77e7ed3eacbfc14e28b20354ecba64' \ -X POST "https://xxxx.com/tracking" \ --data 'since=1504972755' \ --data 'until=1505059155' \ --data 'appId[0]=5180317' \ --data 'appId[1]=3180317' \ --data 'publisherId[0]=15' \ --data 'sdkVersion[0]=v2.5.3' \ --data 'sdkVersion[1]=v2.6' \ --data 'os[0]=Android' \ --data 'os[1]=iOS' \ --data 'countryCode[0]=FR' \ --data 'breakdowns[0]=DAILY' \ --data 'breakdowns[1]=PUBLISHER' \ --data 'breakdowns[2]=APP' \ --data 'breakdowns[3]=SDKVERSION' \ --data 'breakdowns[4]=COUNTRY' \ --data 'breakdowns[5]=OS'
Updated