Skip to main content

​
Supported syncing

For more information about sync modes, refer to the sync modes docs.

​
Connect to AppsFlyer

Go to the Destinations overview page and click the Add destination button. Select AppsFlyer and click Continue. You can then authenticate Hightouch to AppsFlyer by entering the following fields depending on your use case: To sync S2S events:
  • AppsFlyer V2 S2S key to use AppsFlyer’s api3 events endpoint. Follow these instructions in AppsFlyer’s docs to create a S2S key.
  • Dev key (legacy) to use AppsFlyer’s api2 events endpoint. As of December 2023, AppsFlyer has deprecated api2. We recommend updating your configuration to use the S2S key for best performance. If you choose to use a dev key, follow these instructions in AppsFlyer’s docs
For more information about upgrading from api2 to api3, see AppsFlyer’s announcement here. To sync to audiences: You only need to provide credentials for the sync type you intend to use. For example, if you would only like to sync S2S events, you do not need to provide an API key but are required to provide a S2S key.

​
Sync configuration

Once you’ve set up your AppsFlyer destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the AppsFlyer destination you want to sync to.

​
Syncing server-to-server events

You can use server-to-server events to send mobile events that occur outside the app from your servers to AppsFlyer. Appsflyer’s API requires the following event parameters:
  • app_id
  • eventName
  • eventValue
The sync configuration form ensures all these are set and provides some additional options.
To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

​
Appsflyer app ID

The app ID is the identifier used in the AppsFlyer dashboard. Insert it exactly as it appears on the dashboard. You can either provide a static value or select to use a column from your model. Hightouch syncs the static or column value as the app_id path parameter the API requires.

​
Event name

Providing an event name is required to send an event to the Appsflyer API. You can either provide a static value or select to use a column from your model. Hightouch syncs the static or column value as the eventName body parameter the API requires.

​
Event timestamp

You can optionally select a column that contains timestamps of when events occurred. If this field is empty, Appsflyer uses the time the event arrives at the server.

​
Field mapping

Hightouch lets you map model columns to event metadata. Some of the metadata fields you can map to include:
  • AppsFlyer ID
  • IDFV
  • IP
  • Operating system
The AppsFlyer ID is a required field, so ensure you include that in your mapping.

​
Event value mapping

Each event must contain a JSON eventValue, for example:
Hightouch lets you map these fields to create the JSON object the eventValue field expects. Field mapping in the Hightouch UI

​
Custom mappings

You can also map additional custom data that Hightouch sends to the AppsFlyer platform as JSON using the custom_data field.

​
Syncing audiences

This sync type lets you update which users belong to an audience. You must use an existing audience in AppsFlyer.

​
Record matching

To identify which users to add or update in an audience, select model columns and the corresponding AppsFlyer fields. You can match on the following fields:
  • App ID
  • IDFV
  • IDFA
  • GAID
  • OAID
  • IMEI
  • CUID
  • Email
  • Phone
  • Braze ID
  • Amplitude ID
You must include the App ID for all audience types. Depending on whether you’re syncing an Android or iOS audience, you need to include at least one additional identifier. For Android audiences, you must also include at least one of the following:
  • GAID
  • OAID
  • IMEI
  • CUID
  • Braze ID
  • Amplitude ID
For iOS audiences, you must also include at least one of the following:
  • IDFV
  • CUID
  • Braze ID
  • Amplitude ID
See AppsFlyer’s docs on identifiers for more information.

​
Select an existing audience or create a new one

You can create a new audience or use an existing one. When creating a new audience, you can optionally enter a name; otherwise, Hightouch defaults to the name of the associated model. To use an existing audience, you need to enter the audience’s import_key. To get an audience’s import_key follow these instructions:
  1. In the AppsFlyer left-side panel, go to Integration > Audiences.
  2. Click on the name of the audience you want to update.
  3. Select the Import tab.
  4. In the Import using API section, choose Add new devices/users
  5. Copy the import_key in the API request body.
For more information about the Import Audience API, refer to AppsFlyer’s docs.

​
Handling PII and hashing

By default, Hightouch automatically hashes fields that require it before sending them to Appsflyer. You can disable this behavior in the sync configuration. If disabled, the data from the model should be appropriately normalized and hashed according to Appsflyers’s hashing requirements.

​
Delete behavior

The delete behavior you select dictates what to do when an audience member no longer appears in your model’s query results. You have the following options:

​
Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the live debugger. To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up sync alerts. If you run into an issue this page doesn’t cover, .
Last modified on February 7, 2025