At a glance: Aggregated SKAdNetwork postbacks via API. Data is aggregated using postback arrival date. Note! This API doesn't support SKAN 4 postbacks 2 and 3 or SKAN 4-specific data fields.
SKAdNetwork postback arrival date aggregation reporting API
API basics
Overview |
The API returns aggregated SKAdNetwork postbacks, using the postback arrival date range. Note! Postback arrival date differs from the install date used in the SKAdNetwork dashboard and reports. Note! This API doesn't support SKAN 4 postbacks 2 and 3 or SKAN 4-specific data fields. Related reading: Aggregated install date reporting API |
Data freshness |
The report updates Daily. Data availability is according to the SKAdNetwork data freshness rate. |
Path V1 |
V1 is deprecated. The sunset date will be announced in the future. |
Path V2 |
|
Path parameters (mandatory) |
|
Query parameters |
Listed in the table that follows. |
HTTP method | GET |
Response content type | text/plain |
Authorization |
|
Date limitations |
|
Rate limitation |
|
SRN-related remarks |
Google Ads: The postback arrival date is derived using the last-click time reported by Google. |
Parameter name | Details | Mandatory |
---|---|---|
|
The postback arrival date range is bounded by start_date and end_date. Note! The arrival date differs from the install date used in the SKAdNetwork dashboard and reports.
|
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 |
modeled_conversion_values |
|
No |
Request example (cURL)
curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks-postbacks/v2/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 | Available in API V1 | Available in API V2 | Available with modeled data only filter |
---|---|---|---|---|
skad_conversion_value |
Group by | Y | Y | Y |
skad_ad_network_id Some SRNs don't share their ID with us. In this case, the field is blank and ad_network_name is populated. |
Group by |
Y |
Y |
Y |
ad_network_name Currently, in most cases this field is blank. We do populate it in the case of SRNs who don't share their skad_ad_network_id |
Group by | Y | Y | Y |
skad_campaign_id |
Group by | Y | Y | Y |
ad_network_campaign_id |
Group by | Y | Y | Y |
ad_network_campaign_name |
Group by | Y | Y | Y |
ad_network_adset_id |
Group by | N | Y | Y |
ad_network_adset_name |
Group by | N | Y | Y |
ad_network_ad_id |
Group by | N | Y | N |
ad_network_ad_name |
Group by | N | Y | N |
skad_version |
Group by | Y | Y | N |
skad_redownload |
Group by | Y | Y | N |
skad_source_app_id |
Group by | Y | Y | N |
skad_fidelity_type |
Group by | N | Y | N |
geo |
Group by | Y | Y | N |
arrival_date |
Group by | Y | Y | Y |
count |
Measure | Y | Y | Y |
Traits and limitations
Trait | Remarks |
---|---|
Ad network access | Available to analytics partners if the advertiser grants permission. |
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 |
Account user access | The authorization token is available to an admin user 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 |
403 | No permission | You don't have permission to access this report. If you are an analytics partner, ask the advertiser to give you permission. |
404 | Not found |
|
429 | Too many requests |
Exceeded rate limitation |