SDK Tracking 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'

Wiki

mobile.mng-ads.com-mngperf / dispatcher-api