SKAdNetwork postback aggregation API

At a glance: Aggregated SKAdNetwork postbacks via API.

SKAdNetwork postback aggregation reporting API

API basics

Overview The API returns aggregate 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

Example CSV report

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

Some SRNs don't share their ID with us. In this case, the field is blank. 

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  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
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

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

Was this article helpful?