--- title: "AppsFlyer connection guide" slug: "appsflyer-connection-guide" description: "Connect your AppsFlyer data to Supermetrics with our guide. Learn about permissions, API tokens, and query types for effective data integration." updated: 2026-07-08T09:01:35Z published: 2026-07-08T09:01:35Z canonical: "docs.supermetrics.com/appsflyer-connection-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # AppsFlyer connection guide 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](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-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](/docs/appsflyer-connection-guide#connection-instructions). ## 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**** 1. [Log in to AppsFlyer](https://hq1.appsflyer.com/auth/login). 2. Click the email address in the top right corner to open the user menu drop-down. 3. Click **Security center**. 4. Under **AppsFlyer API tokens**, select **Manage your AppsFlyer API tokens**. 5. Copy the V2.0 API token. [Learn more about retrieving and managing your tokens in AppsFlyer's documentation](https://support.appsflyer.com/hc/en-us/articles/360004562377-Managing-API-tokens). ## 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 geo performance (Pull API) report**: Get performance data based on geographical location. - **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](https://support.appsflyer.com/hc/en-us/articles/213223166-Master-API-user-acquisition-metrics-via-API). - **SKAN performance**: Get campaign and installation performance data from Apple’s systems - **Event data export**: Fetch raw event level data, each row is one event logged in AppsFlyer. > [!NOTE] > 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. 1. Select the AppsFlyer data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination. 2. Enter your API token. 3. Give your login a name to recognize it later in case you have multiple logins. 4. If prompted, choose to make this connection [shared or private](https://docs.supermetrics.com/docs/about-shared-and-private-connections). 5. Click **Start**. 6. 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](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub). You can also connect to AppsFlyer from these destinations: - Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets) - Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio) - Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics) - Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi) - The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager) - Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer) - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer) ## More resources - [How to reauthenticate a data source connection](/v1/docs/how-to-reauthenticate-a-data-source-connection) - [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)