Note
The Reporting API shows the installs that are reported by your MMP. To retrieve your billable installs and spend, use the Cost API.
Authentication
Advertisers statistics
Description: Retrieves campaign metrics for an advertiser based on the requested breakdowns and filters. The data can be retrieved in JSON or CSV format.
Method: GET
Endpoint: https://api.ironsrc.com/advertisers/v2/reports?
Parameters
| Name | Mandatory | Data type | Description | Possible values |
|---|---|---|---|---|
startDate | Yes | Date. String in the format: YYYY-MM-DD | ||
endDate | Yes | Date. String in the format: YYYY-MM-DD | Must be within 3 months of the startDate parameter | |
metrics | Yes | Comma-separated list of strings | A list of metrics to be included in the response. The default is none | impressions, clicks, completions, installs, spend |
breakdowns | No | Comma-separated list of strings | A list of breakdowns by which the response data is returned. The default is none | day, campaign, title, application, country, os, deviceType, creative, adUnit |
format | No | String | The format of the response. The default is JSON | json | csv |
count | No | Integer | The number of records to return in the response. The default is 10000 and the maximum is 250000 | |
campaignId | No | Comma-separated list of integers | List of campaign IDs to filter | |
bundleId | No | Comma-separated list of strings | List of bundle IDs to filter | |
creativeId | No | Comma-separated list of integers | List of creative IDs to filter | |
country | No | Comma-separated list of strings by ISO 3166-2 | List of countries to filter | |
os | No | String | Present data for this operating system only | ios | android |
deviceType | No | String | Present data for this device type only | phone | tablet |
adUnit | No | String | Present data for chosen ad units only | rewardedVideo | interstitial | offerWall | banner |
order | No | String | Order the results by breakdown / metric | day | campaign | title | application | creative | country | os | impressions | clicks | completions | installs | spend |
direction | No | String | Order by direction. Default is asc | asc | desc |
Request example
Response
In case of additional data that exceeds the count parameter passed in the request, the response will contain a "next" link that will retrieve the next batch of records.
In a JSON response, the "next" link is in the "paging" property of the response body object. In a CSV response, the "next" link is in the "Link" header of the response.
In case of an empty response, in which no data exists for the requested filters, the JSON format will result in an empty "data" array and the CSV format will lead to a 204 response (no content).
Response example
{ data: [ { "date": "2018-03-31T00:00:00.000Z", "campaignId": 12345, "campaignName": "campaignA", "country": "US", "deviceType": "phone", "impressions": 13016, "clicks": 3980, "completions": 3931, "spend": 5503.4 }, { "date": "2018-03-31T00:00:00.000Z", "campaignId": 12367, "campaignName": "campaign_b", "country": "US", "deviceType": "phone", "impressions": 29600, "clicks": 6179, "completions": 6049, "spend": 4839.2 }, ...... ], paging: { "next": "https://api.ironsrc.com/advertisers/v2/reports/advertiser?breakdowns=day,campaign,country,device_type&metrics=impressions,clicks,completions,spend&format=json&order=spend&direction=desc&count=50&startDate=2018-03-14&endDate=2018-04-14&country=US,CA,GB,FR&os=android&order=day&direction=desc&cursor=anVzdF9zb21lX2N1cnNvcl92YWx1ZQ%3D%3D" } }
Response example
This example shows a response in csv format.
date,campaign_id,campaign_name,country,deviceType,impressions,clicks,completions,spend 2018-03-31T00:00:00.000Z,12345,campaign_a,US,phone,13016,3980,3931,5503.4 2018-03-31T00:00:00.000Z,12367,campaign_b,US,phone,29600,6179,6049,4839.2 2018-03-30T00:00:00.000Z,12345,campaign_a,US,tablet,10716,3173,3150,3868.4 2018-03-30T00:00:00.000Z,12367,campaign_b,CA,phone,24946,4773,4679,3743.2 2018-04-12T00:00:00.000Z,12345,campaign_a,US,phone,9731,2852,2833,3399.6 2018-04-11T00:00:00.000Z,12345,campaign_a,US,phone,10101,2854,2830,3396 2018-04-10T00:00:00.000Z,12345,campaign_a,US,phone,9882,2897,2829,3394.8 2018-04-09T00:00:00.000Z,12345,campaign_a,US,phone,9472,2905,2825,3390 2018-04-07T00:00:00.000Z,12345,campaign_a,US,phone,9251,2854,2824,3388.8 2018-04-14T00:00:00.000Z,12389,campaign_c,FR,phone,151867,14700,145376,2834.98 2018-04-06T00:00:00.000Z,12345,campaign_a,US,phone,7801,2341,2331,2797.2 2018-04-13T00:00:00.000Z,12389,campaign_c,US,phone,142157,11878,136282,2670.95 2018-04-08T00:00:00.000Z,12389,campaign_c,US,phone,131915,19833,126777,2486.97 2018-04-12T00:00:00.000Z,12389,campaign_c,US,phone,114311,10901,109254,2076.85 2018-03-27T00:00:00.000Z,12389,campaign_c,US,phone,123111,14014,117291,2066.89 2018-03-15T00:00:00.000Z,12367,campaign_b,US,phone,13716,3455,3366,2019.6 2018-03-14T00:00:00.000Z,12367,campaign_b,GB,phone,13310,3429,3350,2010 2018-04-05T00:00:00.000Z,12389,campaign_c,GB,phone,103550,14117,99435,1990.22 2018-03-26T00:00:00.000Z,12389,campaign_c,US,phone,116766,14671,110828,1988.14 2018-04-10T00:00:00.000Z,12389,campaign_c,US,phone,104353,13086,99996,1942.66