Prerequisites

• An active AppsFlyer account with access to at least one app exists.

• The App ID and API token are available to authenticate Hevo on your AppsFlyer account. You must be logged in as an Admin user in AppsFlyer to obtain these credentials. Else, you can obtain them from your account administrator.

• You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.

---

Obtaining the App ID and API Token

You require an app ID and an API token to authenticate Hevo on your AppsFlyer account. The app ID is the unique ID of the app listed in the AppsFlyer dashboard whose data you want to replicate to the Destination. You need to create an API token for the listed app.

Note: You must log in as an Admin user to perform these steps.

Step 1. Obtain the App ID

1. Log in to your AppsFlyer account. On the homepage, you can find the apps added to your account.

2. Copy the app ID of the app from which you want to fetch data. Use this ID while configuring your Hevo Pipeline.

   

   Note: The app ID for iOS apps starts with id.

Step 2. Obtain the API Token

1. In the top right of the AppsFlyer homepage, click the drop-down next to your username, and click Security center.

   

2. In the Manage your account security page, scroll down and click Manage your AppsFlyer API tokens.

   

3. In the API tokens page, copy the API token V2.0 and save it securely like any other password. The API token allows Hevo to pull raw and aggregated data reports from AppsFlyer. Use this token while configuring your Hevo Pipeline.

   

---

Configuring AppsFlyer as a Source

Perform the following steps to configure AppsFlyer as the Source in your Pipeline:

1. Click PIPELINES in the Navigation Bar.

2. Click + CREATE PIPELINE in the Pipelines List View.

3. In the Select Source Type page, select AppsFlyer.

4. In the Configure your AppsFlyer Source page, specify the following:

   

   • Pipeline Name - A unique name for your Pipeline, not exceeding 255 characters.

   • App ID - The unique ID of your AppsFlyer app that you obtained from your AppsFlyer account.

   • API Token - The API token that you obtained from your AppsFlyer account.

   • Pull API Timezone - The timezone in which you want to receive the data.

5. Click TEST & CONTINUE.

6. Proceed to configuring the data ingestion and setting up the Destination.

---

Migrating from AppsFlyer API V1 Token to V2

Effective September 18, 2023, AppsFlyer has discontinued support for the API V1 token to fetch raw and aggregated data reports from your AppsFlyer app. Therefore, you must replace the V1 token with the V2 token in your existing Pipelines to prevent data ingestion failures.

Note:

• Replacing the API token does not affect the data replication process.

• Once you update the API token in your existing Pipeline, you cannot revert to using the V1 token for fetching data from your AppsFlyer app.

Perform the following steps to replace the API token in an existing Pipeline:

1. Click PIPELINES in the Navigation Bar.

2. Search for your AppsFlyer Source Pipeline and click anywhere in its Pipeline Summary row.

   

3. Click the Settings ( ) icon next to the Source name.

4. In the hover window that appears, click the Edit ( ) icon.

   

5. In the Edit AppsFlyer Pipeline connection settings page, specify the API Token V2 that you retrieved in the Obtain the API Token step above.

   

6. Click TEST & SAVE.

---