SKAN aggregated postback arrival date API

At a glance: Aggregated SKAdNetwork postbacks via API. Data is aggregated using postback arrival date. 

SKAN aggregated postback arrival date API

The API returns aggregated SKAdNetwork postbacks, using the postback arrival date range.

Note! Postback arrival date differs from the install date used in the SKAdNetwork dashboard and reports.

Using SKAN aggregated performance report API

To use SKAN aggregated performance report API:

  1. Get the API token. An admin needs to retrieve the token.
  2. Give your developer the API token to be used in the authentication header.
  3. Give your developers the parameters to input when they make the API call, as described in the section that follow. The parameters determine what the report focuses on, how it's organized, and provide a reporting timeframe.
  4. Tell your developer to follow their SKAN aggregated performance report API in the developer hub.

Parameters

Parameter name Details Mandatory

start_date

The postback arrival date range is bounded by start_date and end_date. Note! The arrival date differs from the install date used in the SKAdNetwork dashboard and reports.

  • 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

modeled_conversion_values
  • Only supported from V2
  • Value can be either true or false
  • If true, the postback populates the “count” column with modeled conversion value data.  See available field for modeled data
  • If false, the postback presents the conversion value count and with all available fields as received by listed in the report structure, without modeled data.
  • Default value is false.

No

Report structure and example

The API returns a CSV file.

Columns and metrics available are listed in the table that follows.

Examples: V1 | V2

SKAdNetwork aggregate report structure
Column name Dimension or measure Available with API V1 token Available with API V2 token Available with API V2 token (for SKAN 4) Available with modeled data only filter
skad_postback_sequence_index Group by N N Y Y

skad_conversion_value

Group by Y Y Y Y

skad_coarse_conversion_value

Group by N N Y Y

skad_ad_network_id

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

Group by

Y

Y

Y

Y

ad_network_name

Currently,  in most cases this field is blank. We do populate it in the case of SRNs who don't share their skad_ad_network_id

Group by Y Y Y Y

skad_source_identifier

group by N N Y Y

skad_campaign_id

Group by Y Y Y Y

ad_network_campaign_id

Group by Y Y Y Y

ad_network_campaign_name

Group by Y Y Y Y

ad_network_adset_id

Group by N Y Y Y

ad_network_adset_name

Group by N Y Y Y

ad_network_ad_id

Group by N Y Y N

ad_network_ad_name

Group by N Y Y N

ad_network_creative

Group by N N Y N

ad_network_channel

Group by N N Y N

skad_version

Group by Y Y Y N

skad_redownload

Group by Y Y Y N

skad_source_app_id

Group by Y Y Y N

skad_source_domain

Group by N N Y Y

skad_fidelity_type

Group by N Y Y N

geo

Group by Y Y Y N

arrival_date

Group by Y Y Y Y

count

Measure Y Y Y Y

Specifications and limitations

Spec Remarks 
Data freshness

The report updates Daily.

Data availability is according to the SKAdNetwork data freshness rate.

Date range
  • Earliest date supported: November 1, 2020
  • Maximum query range: 60 days
Rate limit
  • Queries return up to 200K rows
  • 60 calls per minute
SRNs

Google Ads: The postback arrival date is derived using the last-click time reported by Google. 

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 Not available with this API
Non-organic data Calculated using SKAdNetwork postbacks received by AppsFlyer
Historical data Earliest conversion data (install or retarget) supported: November 1, 2020
Account user access The authorization token is available to an admin user in the dashboard.