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 |
Data freshness |
|
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 | Format | Mandatory |
---|---|---|
|
|
Yes |
end_date |
|
Yes |
view_type |
Filter the installs by type as follows:
|
No |
Request example (cURL)
curl --request \
GET 'https://hq1.appsflyer.com/api/skadnetworks/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_report_<view_type>
_<start-date>_<end-date>_<unique-report_hash>_UTC_.csv
Available fields
- Columns and metrics available are listed in the table that follows.
- Some metrics (revenue, engagement, conversion) depend on the SKAdNetwork performance measurement settings.
- Example CSV file
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 |
{engagment in-app event} Event counter |
Engagement metric |
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 |