SKAdNetwork Reporting API V3 (Archived)

DEPRECATED API VERSION

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 \| storeOpens \| 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 \| 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": 1308816,
            "storeOpens": 98675
            "installs" : 9765, 
            "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": 42960008,
            "storeOpens": 985675 
            "installs" : 87643,
            "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": 2954600,
            "storeOpens": 98675             
            "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,storeOpens,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,storeOpens,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,392480,2343,5503.4,15432,14397,12346,...,2233,1032
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,US,613759,5456,4839.2,5432,1397,1346,...,233,132
2021-04-16T00:00:00.000Z,12345,campaign_a,com.abc.il,US,314673,5467,3868.4,1532,1397,1246,...,23,2
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,CA,457373,23543,3743.2,5432,1397,346,...,33,12
2021-04-16T00:00:00.000Z,12345,campaign_a,com.abc.il,US,268452,45454,3399.6,432,397,246,...,3,0
2021-04-16T00:00:00.000Z,12367,campaign_b,com.abc.il,GB,345259,2356,3350,2010,1332,1107,1236,...,233,132
2021-04-16T00:00:00.000Z,12389,campaign_c,com.abc.il,GB,14234117,23454,99435,1990.22,15432,14397,12346,...,33,12
2021-04-16T00:00:00.000Z,12389,campaign_c,com.abc.il,US,145432671,23454,110828,1988.14,1432,1427,1346,...,23,1