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

SKAdNetwork performance reporting API

Avatar
Daniel Bram
Last update:
  • Advertisers

At a glance: iOS campaign performance SKAdNetwork metrics enriched with additional data points. Similar to the data in the SKAdNetwork dashboard. Limited to real data, meaning you can't get SKAd simulated data.

SKAdNetwork performance reporting API

API basics

Overview The API returns attribution metrics reported by Apple SKAdNetwork (real data) and other data points. The report is similar in structure to the data presented in the SKAdNetwork dashboard. 
Data freshness
  • The report updates Daily. Relating to installs occurring 3 days ago. Meaning on March 31, installs for March 28 are available. 
  • Data availability is according to the SKAdNetwork data freshness rate.
Path

https://hq1.appsflyer.com/api/skadnetworks/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 displays 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
  • When setting the date range the most recent date should be the current date UTC time zone minus 3 days. Meaning on March 31, use March 28. 
  • Earliest date supported: November 1, 2020
  • Maximum query range: 90 days
Rate limitation
  • Queries return up to 200K rows
  • 60 calls per minute
API facts
Query parameters
Parameter name Format Mandatory

start_date
  • Earliest install date having format YYYY-MM-DD 
  • Earliest date permitted: 2020-11-01
    Example: 2020-11-05
 Yes
end_date
  • Most recent install date having format YYYY-MM-DD
  • Maximum number of days per report call: 90 days 
  • Example: 2020-11-12
 Yes
view_type

Filter the installs by type as follows: 

  • acquisition: Installs 
  • retargeting: Redownloads
  • unified: Acquisition and redownloads combined.
  • [Default] unified
  • Ad spend metrics return when view_type=unified

No

Request example (cURL)

curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks/v1/data/app/<app_id>?start_date=2020-11-10&end_date=2020-11-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_report_<view_type>
_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv

Available fields

SKAdNetwork aggregate report structure
Column name Dimension or metric
Media Source (pid) Group by
Campaign (c)

Group by
Campaign ID Group by
Site ID Group by
Country Group by
Impressions Metric
Clicks Metric
CTR Metric
Installs Metric
Conversion Rate Metric
Converted Users Metric
Converted Users/Installs Metric
Total Revenue Revenue metric
Total Cost Metric
ROI Revenue metric
ARPU Revenue metric
Average eCPI Metric
{af_skad_revenue} unique users Revenue metric
{af_skad_revenue} event counter Revenue metric
{conversion in-app event [n]} unique users (n=1..6) Conversion metric
{conversion in-app event [n]} event counter (n=1..6) Conversion metric
{engagement in-app event} unique users Engagement metric

{engagement in-app event}

event counter

 Engagement metric

 

Traits and limitations

Trait
Trait Remarks 
Ad network access  If you are an analytics partner, ask the advertiser to grant you 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. The earliest recommended date is the current date UTC time, less 3 days. For example: If the current date UTC timezone is March 31, the earliest date you should use is March 28. 
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?

Articles in this section

Related articles