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
TIP
For more information about AppsFlyer and IDFA, take a look at AppsFlyer's documentation:
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
IMPORTANT
You must track user ID values with the AppsFlyer SDK in order to send postbacks from AppsFlyer to Iterable. For postbacks to be successful, the user IDs that you set up in AppsFlyer and Iterable must match. If you haven't set up an AppsFlyer customer user ID (CUID) for some of your users, you won't be able to track their install and event postbacks in Iterable.
Learn more about the AppsFlyer Customer User ID (CUID) field.
To integrate AppsFlyer postbacks with Iterable:
-
In AppsFlyer, navigate to the Integrated Partners page to enable the integration. Search for Iterable to find the configuration:
-
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:
TIP
Before getting started, set up your iOS and Android apps to support deep links. For more information, read iOS Universal Links Setup and Android App Links Setup.
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.
WARNING
To complete the steps below, first set up an AppsFlyer OneLink™ and enable deep linking.
Step 2: Set up Iterable
In Iterable, do the following:
-
If you don't yet have one, create a tracking domain, as described in our Email Setup guide.
Configure HTTPS for your tracking domain.
To your tracking domain, add your AppsFlyer OneLink domain (
<YOUR_DOMAIN>.onelink.me
) as a destination domain.-
For your new destination domain, set up an
apple-app-site-association
file and anassetlinks.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):
Set up your apps to support deep links. To learn how, read AppsFlyer's Setting up your app documentation.
-
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.
-
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.
Comments
0 comments
Article is closed for comments.