SKAdNetwork Reporting API

Authentication

Bearer API authentication

Description: This API lets you retrieve SKAdNetwork campaign data, including impressions, installs, spend, and conversion values. You can also use it to break down data by campaign, country, ad unit, date and more.

The data can be retrieved in JSON or CSV formats. 

Method: GET

Endpoint: https://api.ironsrc.com/advertisers/v3/reports/skan?

Note: The request rate for this endpoint is limited to 100 requests per minute. If you exceed the limit, requests will be returned with error status 429 (too many requests). Using multiple breakdowns and multiple comma-separated filter values can also reduce the number of requests.

Parameters

Name Mandatory Data type Description Possible values
startDate Yes Date (UTC); String in the format: YYYY-MM-DD
endDate Yes Date(UTC); String in the format: YYYY-MM-DD
metrics Yes Comma-separated list of strings A list of metrics to be included in the response. impressions | installs | spend | conversionValues
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 | adUnit
format No String The format of the response. The default is JSON. json | csv
campaignId No Comma-separated list of integers List of campaign IDs to filter. Applicable only for SKAN reporting or SKAN reporting and Optimization campaigns.
bundleId No Comma-separated list of strings List of bundle IDs to filter. e.g “com.bundle.name.com”
country No Comma-separated list of strings by ISO 3166-2 List of countries to filter.
adUnit No String Present data for chosen ad units only. rewardedVideo | interstitial
count No Integer The maximum number of records to return in the response. The default is 10000.
order No String Order the results by breakdown/metric. day | campaign | title | application | country | impressions | installs | spend
direction No String Order by direction. Default is asc. asc | desc

Request example

https://api.ironsrc.com/advertisers/v3/reports/skan?campaignId=1234567,7654321&country=US,CA&breakdowns=country,day&metrics=impressions,
installs,spend,conversionValues&count=100&startDate=2021-04-14&endDate=2021-04-23&direction=desc

Response

If the data in the request exceeds the count parameter, the response will contain a “next” link that will retrieve the next batch of records.

In a JSON response, the “next” link is included in the “paging” property of the response body object. In a CSV response, the “next” link is included in the “Link” header of the response.

If a response is empty and 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).

{
    data: [
     {
            "date": "2021-04-15T00:00:00.000Z",
            "campaignId": 7654321,
            "campaignName": "campaignA",
            "titleBundleId": "com.abc.abc.il",
            "country": "US",
            "impressions": 13016,
            "installs" : 98765 
            "spend": 5503.4,
            "conversionValues": {
               "0": 8732,
               "1": 6752,
               "2": 5233,
               "3": 4783,
               "4": 3772,
               ..........
               "61": 874,
               "62": 459,
               "63": 162
            } 
        },
        {
            "date": "2021-04-16T00:00:00.000Z",
            "campaignId": 1234567,
            "campaignName": "campaign_b",
            "titleBundleId": "com.abc.abc.il", 
            "country": "US",
            "impressions": 29600,
            "installs" : 876543
            "spend": 4839.2,
            "conversionValues": {
               "0": 15432,
               "1": 14397,
               "2": 12346,
               "3": 11783,
               "4": 11276,
               ..........
               "61": 1245,
               "62": 2233,
               "63": 1032
            } 
        }, 
        {             
            "date": "2021-04-16T00:00:00.000Z",             
            "campaignId": 1234567,             
            "campaignName": "campaign_b",
            "titleBundleId": "com.abc.abc.il", 
            "country": "CA", 
            "impressions": 29600,            
            "installs" : 23456             
            "spend": 3234.98, 
            "conversionValues": {
               "0": 5732,
               "1": 3702,
               "2": 2833,
               "3": 1783,
               "4": 772,
               ..........
               "61": 0,
               "62": 0,
               "63": 0
            }         
        }
    ],
    paging: {
        "next": "https://api.ironsrc.com/advertisers/v3/reports?campaignId=1234567,7654321&country=US,CA&breakdowns=country,day&metrics=impressions,installs,spend,conversionValues&count=100&startDate=2021-05-01&endDate=2021-06-7&direction=desc&cursor=anVzdF9zb21lX2N1cnNvcl92YWx1ZQ%3D%3D"
    }
}

Response example – CSV format

date,campaign_id,campaign_name,country,impressions,installs,spend,impressions,spend,installs,
conversionValue_0,conversionValue_1,conversionValue_2,...,conversionValue_63,conversionValue_65
2021-04-16T00:00:00.000Z,12345,campaign_a,com.abc.il,US,3980,5503.4,15432,14397,12346,...,2233,1032
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,US,6179,4839.2,5432,1397,1346,...,233,132
2021-04-16T00:00:00.000Z,12345,campaign_a,com.abc.il,US,3173,3868.4,1532,1397,1246,...,23,2
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,CA,4773,3743.2,5432,1397,346,...,33,12
2021-04-16T00:00:00.000Z,12345,campaign_a,com.abc.il,US,2852,3399.6,432,397,246,...,3,0
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,GB,3429,3350,2010,1332,1107,1236,...,233,132
2021-04-16T00:00:00.000Z,12389,campaign_c,com.abc.il,GB,14117,99435,1990.22,15432,14397,12346,...,33,12
2021-04-16T00:00:00.000Z,12389,campaign_c,com.abc.il,US,14671,110828,1988.14,1432,1427,1346,...,23,1