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 aggregated install date performance API
API basics
| Overview | The API returns attribution metrics reported by Apple SKAdNetwork (real data) and other data points using the app install date. The report is similar in structure to the data presented in the SKAdNetwork dashboard. |
| Data freshness |
Data availability is according to the SKAdNetwork data freshness rate. |
| 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 |
|
| SRN-related remarks |
|
The admin | Parameter name | Format | Mandatory |
|---|---|---|
|
|
The install date range is bounded by start_date and end_date. Note! Install date differs from postback arrival date.
|
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-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_.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 |
|
{engagement in-app event} event counter |
Engagement metric |
Traits and limitations
| 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
| 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 |
| 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 |