At a glance: The SKAdNetwork postback aggregate reporting API provides iOS campaign attribution metrics, as reported to AppsFlyer by Apple SKAdNetwork.
SKAdNetwork aggregate postback reporting API
API basics
Overview | The API returns raw SKAdNetwork postbacks, as received by AppsFlyer |
Data freshness |
The report updates Daily. Data availability is according to the SKAdNetwork data freshness rate. |
Path |
|
Path parameters (mandatory) |
|
Query parameters |
Listed in the table that follows. |
HTTP method | GET |
Response content type | text/plain |
Authorization |
|
Date limitations |
|
Rate limitation |
|
Parameter name | Details | Mandatory |
---|---|---|
|
|
Yes |
end_date |
|
Yes |
ad_network_name |
Filter by media source |
No |
geo |
Filter by country code using ISO 3166 (alpha-2). Example: US , CN |
No |
skad_redownload |
Filter by |
No |
skad_source_app_id |
Filter by source app ID |
No |
ad_network_campaign_id |
Filter by ad network campaign ID. Note: This is not the campaign ID reported by SKAdNetwork. |
No |
Request example (cURL)
curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks-postbacks/v1/data/app/<app_id>?start_date=2020-09-10&end_date=2020-09-20' \
--header 'Authorization: Bearer <V2_AUTH_TOKEN_HERE (700+ characters string)>'
Report structure and example
The API returns a CSV file with the following naming scheme:
<app_id>_skadnetworks_postbacks_report_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv
Available fields
Columns and metrics available are listed in the table that follows.
Column name | Dimension or measure |
---|---|
skad_conversion_value |
Group by |
skad_ad_network_id |
Group by |
ad_network_name |
Group by |
skad_campaign_id |
Group by |
ad_network_campaign_id |
Group by |
ad_network_campaign_name |
Group by |
skad_version |
Group by |
skad_redownload |
Group by |
skad_source_app_id |
Group by |
geo |
Group by |
arrival_date |
Group by |
count |
Measure |
Traits and limitations
Trait | Remarks |
---|---|
Ad network access | Not available |
Agency access | Not available |
App-specific time zone | UTC only |
App-specific currency | Always USD |
Organic data | Calculated as the difference between all data reported by SDK directly to AppsFlyer less non-organic data reported by SKAdNetwork postbacks |
Non-organic data | Calculated using SKAdNetwork postbacks received by AppsFlyer |
Historical data | Earliest conversion data (install or retarget) supported: November 1, 2020 |
Team member access | The authorization token is available to the account admin in the dashboard. |
HTTP response codes and troubleshooting
HTTP | Response |
Remarks |
---|---|---|
200 | OK |
Valid data returned (CSV) |
200 | OK |
Empty report - no data found for the specified date range (CSV, only column names are returned).
|
400 | Bad request |
Missing or invalid query parameters |
401 | Unauthorized |
Authorization token is missing or invalid Make sure you use the token correctly |
404 | Not found |
|
429 | Too many requests |
Exceeded rate limitation |