AppsFlyer + Iterable Integration

Iterable integrates with AppsFlyer to help customers unify their acquisition, activation, and engagement strategies—and to facilitate deep linking.

# In this article

# Postbacks

The available macros/datafields in these install postbacks are:

• attr_source : "AppsFlyer"
• media_source: AppsFlyer Partner ID
• campaign: Campaign Name
• adset: Adset Name
• ad: Ad
• adgroup: Ad Group
• publisher_id: Publisher ID
• match_type: Fingerprinting, Device ID or Referrer
• is_attributed: 0 (organic) or 1 (non-organic)
• retargeting_type: Retargeting type
• af_timestamp: AppsFlyer Install time
• idfa: iOS Advertiser ID
• advertiserId: Android Advertiser ID
• app_id: App ID
• app_name: App Name (as displayed in AppsFlyer)
• language: device language
• user_agent: device user-agent
• platform: iOS or Android

These come through as custom tracking events, called install, via Iterable's POST /api/events/track API endpoint.

The post-install events contain the same macros, with additional fields to denote event and revenue-based values:

• event_name: Event named tracked in AppsFlyer
• attr_source : "AppsFlyer"
• media_source: AppsFlyer Partner ID
• campaign: Campaign Name
• adset: Adset Name
• ad: Ad
• adgroup: Ad Group
• publisher_id: Publisher ID
• match_type: Fingerprinting, Device ID or Referrer
• is_attributed: 0 (false) or 1 (true)
• retargeting_type: Retargeting type
• event_value: Event value json from AppsFlyer
• revenue_usd: Event Revenue in USD
• revenue: Event Revenue in currency it was sent to AppsFlyer as
• currency: Currency AppsFlyer originally received with the event
• af_timestamp: AppsFlyer Event timestamp
• idfa: iOS Advertiser ID
• advertiserId: Android Advertiser ID
• app_id: App ID
• app_name: App Name (as displayed in AppsFlyer)
• language: device language
• user_agent: device user-agent
• platform: iOS or Android

Event names are passed through as they are named and tracked via AppsFlyer.

# Setting up AppsFlyer postbacks

To integrate AppsFlyer postbacks with Iterable:

1. In AppsFlyer, navigate to the Integrated Partners page to enable the integration. Search for Iterable to find the configuration:

   

2. In the Iterable integration, place your Iterable API key into the api_key field and enable the events that you’d like to send across to Iterable. There are no tracking links or data enrichment features as a part of this current integration:

   

# Deep linking

To set up deep linking and attribution with AppsFlyer, complete the following steps:

# Step 1: Set up AppsFlyer

First, set up your AppsFlyer account. Follow their guide, and then confirm that deep links work on their platform before integrating with Iterable.

# Step 2: Set up Iterable

In Iterable, do the following:

1. If you don't yet have one, create a tracking domain, as described in our Email Setup guide.

   

2. Configure HTTPS for your tracking domain.

3. To your tracking domain, add your AppsFlyer OneLink domain (<YOUR_DOMAIN>.onelink.me) as a destination domain.

4. For your new destination domain, set up an apple-app-site-association file and an assetlinks.json file.

   TIP

   For more information about this step, take a look at AppsFlyer's documentation.

   To set up an apple-app-site-association file:

   • In your web browser, navigate to:

     https://<YOUR_APPSFLYER_ONELINK>/.well-known/apple-app-site-association
     

     For example:

     https://yourdomain.onelink.me/.well-known/apple-app-site-association
     

   • Copy and paste the contents of this file into the Apple section of your destination domain's configuration.

   To set up an assetlinks.json file:

   • In your web browser, navigate to: https://<YOUR_APPSFLYER_ONELINK>/.well-known/assetlinks.json

   • Copy and paste the JSON content from your browser page into the Android section of your destination domain configuration.

   TIP

   For more information, read Deep Links Setup.

# Step 3: Set up the AppsFlyer SDK in your mobile apps

Finally, update the code for your iOS and Android apps (using AppsFlyer's iOS and Android SDKs):

1. Set up your apps to support deep links. To learn how, read AppsFlyer's Setting up your app documentation.

2. Call AppsFlyer's setResolveDeepLinkURLs method to fetch your OneLink URL from AppsFlyer.

   To learn more, read AppsFlyer's documentation about this method on iOS and Android.

3. After fetching your OneLink URL, call AppsFlyer's onAppOpenAttribution method to get additional deep linking and attribution metdata from AppsFlyer.

   For more information, read AppsFlyer's documentation about this method on iOS and Android

# Need help with AppsFlyer?

To contact AppsFlyer support, email support@appsflyer.com.