AppsFlyer connection guide

Supermetrics Support Site Team

Modified on: Fri, 14 Feb, 2025 at 1:58 PM

This guide contains all permissions and requirements for connecting your AppsFlyer data to Supermetrics.

You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.

After you connect to the data source on the Hub, you can use the data source connection in all available destinations.

Required permissions

Note that the AppsFlyer connector doesn't work with AppsFlyer agency accounts. The connector uses the apps list endpoint for fetching a list of all available apps and it does not support agencies.

To connect Supermetrics to AppsFlyer, you need:

Account admin access
API token (V2.0)

Retrieve your API tokens

Log in to AppsFlyer.
Click the email address in the top right corner to open the user menu drop-down.
Click Security center.
Under AppsFlyer API tokens, select Manage your AppsFlyer API tokens.
Copy the V2.0 API token.

Learn more about retrieving and managing your tokens in AppsFlyer's documentation.

Query types

Query types define what sort of metrics and dimensions are available. Supermetrics supports 2 query types to fetch performance data on how different marketing channels and user acquisition sources perform. You need to select one of the following query types when pulling data:

Aggregated performance (Pull API) report: Get basic aggregated performance data for your mobile apps. This report is available for all AppsFlyer users.
Aggregated performance (Master API) report: Fetch more granular data with less restrictive rate limits, including ad group, ad, and keyword splits. The Master API requires a separate subscription; please contact AppsFlyer to gain access. Learn more about the Master API in AppsFlyer's documentation.
Event data export: Fetch raw event level data, each row is one event logged in AppsFlyer.
The raw data from the Event data export query type (any fields that begin with raw_data_) is only available in data warehouse destinations and the Supermetrics API. You also need an Enterprise AppsFlyer subscription with raw data API enabled.

Connection instructions

When connecting to AppsFlyer, you need to provide your API token.

Select the AppsFlyer data source on the Supermetrics Hub or in the data destination.
Enter your API token.
Give your login a name to recognize it later in case you have multiple logins.
If prompted, choose to make this connection shared or private.
Click Start.
In your data destination, select the query type to use.

See detailed instructions on how to connect to a data source from the Supermetrics Hub.

You can also connect to AppsFlyer from these destinations: