AppsFlyer App Events Connector Setup Guide

This article describes how to set up the AppsFlyer App Events connector in your Customer Data Hub account.

This connector replaces the DEPRECATED AppsFlyer App Events Connector.

Connector Actions

Action Name AudienceStream EventStream
Track Install
Track in App Event

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

  • App ID

    • This is the App ID of the app for which you are passing data.
  • Dev Key

    • The account dev key taken from the App Settings screen in the AppsFlyer dashboard.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

  • In the Action Name box, enter a name for the action.
  • In the Action Type list, select the type of action to track.
  • In the Platform list, select the platform the event came from. Your selection determines which parameters appear in the mapping table.
    • Android
    • iOS
    • Windows

This section describes how to set up parameters and options for each action.

Action - Track Install


The Platform Data parameters are required. The Apple Search Ads and Custom Data parameters are optional.

Platform Data
Parameter Platform Description
Ad ID Enabled Flag (required) All Set this parameter to true to opt the user out of AppsFlyerAnalytics.
App Open Counter (required) All Set this parameter to 1 or 2 for first launch attribution, or set it to 3 or higher for retargeting.
Device Advertising ID (required) Android or Windows The device’s advertising ID. For example: caf5555d48f22222d34f03bcd7ab333b.
Device IP Address (required) All The device’s IP address.
Device Locale (required) All The device’s locale. For example: en-US.
Device Type/Model (required) All The device’s type or model.
Install Date (required) All The first launch date or install date of the application on the device, in ISO 8601 UTC format. For example: 2015-01-22T08:45:33.412.
iOS Ad ID (required) iOS The OS ID for Advertisers (advertisingIdentifier), which can be sha1 hashed. For example: AC9FB4FB-AAAA-BBBB-88E6-2840D9BB17F4.
OS Version (required) All The operating system version.
Unique User ID (required) All The unique user ID. For example: 1b1758cd-c22b-461e-924e-ceb0c7f849aa.
User Agent (required) All The application’s user agent.
App Bundle ID iOS The app bundle ID. For example:
Customer User ID IOS and Android The customer user ID, as set by the developer. The advertiser’s system will use this as the user identifier. For example: 3d4d05e5-9ae4-4755-9363-8166568f7935.
Device IMEI Android The device’s IMEI, which can be sha1 hashed.
Device Android ID Android The device’s Android ID, which can be sha1 hashed.
Facebook Tracking Cookie Value Android and Windows The Facebook Tracking Cookie’s value.
Full DeepLink URL All The full DeepLink URL of the tracking call. For example:myapp://page/1?param1=val1.
Google Play Referrer Android The referrer received from Google Play receiver, without URL-encoding. For example: af_tranid=1A4F123KJHG73F0P&c=c1&pid=MediaSource1.
Windows Store Referrer Windows The Windows Referrer received from Windows Store, without URL-encoding. For example: af_tranid=1A4F123KJHG73F0P.
iOS Identifier for Vendor iOS The iOS Identifier for the Vendor. For example: 95C9BD22-4A4C-41C8-9548-ED07C5C8C145.
App Tracking Transparency iOS 14 and above Set this parameter to indicate if the user opted out of the use of IDFA:
  • - Not determined.
  • 1 - Restricted.
  • 2 - Denied.
  • 3 - Authorized.
For more information, see: ATTrackingManager.AuthorizationStatus.
App Type iOS If this is an app clip install.
Open Anonymous Device Identifier Android The Open Anonymous Device Identifier. For example: 57cfbf44-edfc-9f25-7fcf-7 3fdffc59929.
Amazon Advertising ID Android The unique advertising ID for Amazon devices. For example:24c5f114-7718-4a12-97d9-1273397be3c6.
App Store Android The store from which the app was downloaded.
Apple Search Ads
Parameter Description
iad-adgroup-id Ad ID group ID.
iad-adgroup-name Ad ID group name.
iad-attribution Ad ID attribution.
iad-campaign-id Ad ID campaign ID.
iad-campaign-name Ad ID campaign name.
iad-click-date Ad ID click date.
iad-conversion-date Ad ID conversion date.
iad-keyword Ad ID keyword.
iad-lineitem-id Ad ID line item.
iad-lineitem-name Ad ID line item name.
iad-org-name Ad ID organization name.
Custom Data

Use this section to add any customized information to the event message.

Action - Track in App Event


The Platform Data and Event Data parameters are required. The Custom Data parameters are optional.

Platform Data

This action uses the same Platform Data parameters as The Track Install action.

Event Data
Parameter Description
Event Currency
  • The default currency for the event
  • Only use for USD, for all else, map under the Event Properties__ (event_value) section using the af_currency key.
Event Name (required) A string describing the event name. For example: af_purchase.
Custom Data

Use this section to add any customized information to the event message.

Was this page helpful?

This page was last updated: June 14, 2022