1. Help Center
  2. Reporting
  3. Analytics and aggregate reporting/APIs

SKAdNetwork aggregate postback reporting API

Avatar
Daniel Bram
Last update:
  • Developers

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

https://hq1.appsflyer.com/api/skadnetworks-postbacks/v1/data/app/<app_id>
Path parameters (mandatory)

<app_id>: Is the app identifier, as found in the AppsFlyer dashboard. Insert it exactly as it appears in the dashboard. Example: id123456789

Query parameters

 Listed in the table that follows.
HTTP method GET
Response content type text/plain
Authorization

Authorization HTTP header containing API V2.0 token (Bearer token) is required.

AppsFlyerAdmin_us-en.pngThe admin gets the V2 token in the dashboard, go to your email address > API tokens. 
Date limitations
  • Earliest date supported November 1, 2020
  • Maximum query range: 60 days
Rate limitation
  • Queries return up to 200K rows
  • 60 calls per minute
API facts
Query parameters
Parameter name Details Mandatory

start_date
  • YYYY-MM-DD 
  • Earliest date permitted: 2020-11-01
    Example: 2020-11-05
 Yes
end_date
  • YYYY-MM-DD
  • Maximum number of days per report call: 60 days 
  • Example: 2020-11-12
 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 true or false

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. 

SKAdNetwork aggregate report structure
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
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

Response codes and troubleshooting guide
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).

  • In the SKAdNetwork dashboard, verify that data is available for the specified date range.
  • Verify that start_date is a date earlier than yesterday.
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
Was this article helpful?

Articles in this section

Related articles