At a glance: The SKAdNetwork aggregate reporting API provides iOS campaign attribution metrics reported by Apple SKAdNetwork infrastructure and additional data points. The data available is similar to that available in the SKAdNetwork dashboard.
SKAdNetwork aggregate reporting API
API basics
| Overview | The API returns attribution metrics reported by Apple SKAdNetwork 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 |
|
The admin | 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_.csvAvailable 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: October 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 |