As of September 5, 2023, V1 API tokens will stop working. It is recommended to only connect new sources with V2 tokens, and to reconnect all existing data sources using V1 tokens using a V2 token. More information below.
Content
Reports available
• Raw data reports
• Aggregated reportsReport differences
• Dimensions & metrics
• Country definitions
• Organic data
• LTV vs Activity
• Historical data
Authorization
API Token - The API token can be found in the API Token page of your AppsFlyer app page. All admins can retrieve V2.0 token. Make sure to generate an API Token, not an S2S Token, as the latter is not compatible with our connector.
Please see AppsFlyer documentation for more information.
Note: Please make sure you are using a Advertiser (app owner) token if you are connecting a Aggregated: SKAdNetwork performance report.App ID - Login to your AppsFlyer account at My apps where your App ID can be found under the App name. It will have the reverse URL format for Android apps (eg.
com.example.app) and an ID for iPhone apps (egid123456789).
API access needed
Go to Integration > API Access to view the list.
Raw Data pull API - Needed for all Raw Data reports
Organic Raw Data pull API - Needed for all Organic Raw Data reports
Performance reports pull API - Needed for Aggregated reports
V1 vs V2 API Tokens
As mentioned in the beginning of the article, AppsFlyer will stop support V1 API tokens September 5, 2023. For the connector to continue to download data you must.
Retrieve an V2 API token, as described in Authorization
Find the sources using V1 tokens by looking at the Definition label in Funnel.
Try to reconnect one source to start with and verify that the download is working
If you have several more sources, use the opportunity to reconnect sources in bulk by selecting several sources.
N.b. the Definition label will not reflect the token used immediately. So even though it says V1 token after the reconnect, V2 token will be used but the definitional label will show V1 for up to 24 hours.
Reports available
Raw Data reports
AppsFlyer premium feature, read more about these reports here.
In-App events
Installs
Uninstalls
Organic In-App events
Organic Installs
Aggregated reports
Read more about these reports here.
Daily Report
Geo by Date
Partner by Date
SKAdNetwork performance
Report differences
Dimensions & metrics
The Raw Data reports has more granularity in that it has a lot more dimensions and where each row is an event. The Aggregated report has fewer dimensions but has aggregated metrics (i.e. Sessions, Loyal Users) as well as Cost data (in the Daily Partner report).
Country definitions
The country of the installation is used in the Aggregated reports.
The country of the event is used for Raw Data reports.
Organic data
Aggregated report include both paid and organic data.
Raw Data reports has paid and organic in different reports (and organic reports require specific AppsFlyer permissions).
LTV vs Activity
The Aggregated reports contain metrics with Life Time Values (LTV) and shows each event aggregated on the Install Date.
The Raw Data reports show each event attributed to the Event Date (aka Activity Date).
That means that a purchase made today will be shown if you look at today for Raw Data reports, but it will be shown for the date the user installed the App (up to 2 years back) for the Aggregated reports.
The Aggregated reports will match how the AppsFlyer UI aggregates the data. However if you compare the Raw Data reports with the AppsFlyer UI you will have to look at the Install Date in Funnel instead of the ordinary Date dimension.
Read more about what AppsFlyer says about the date attribution differences here.
Historical data
For Aggregated reports we go back until the date of the first app install recorded in AppsFlyer or maximum 2 years back (unless more is requested). The SKAdNetwork performance reports support data from 1 November 2020 at the earliest.
For Raw data reports we go up to 90 days back, depending on user quota limitations.