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
Parameters
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: com.company.appname. |
| 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:
|
| 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
Parameters
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 |
|
| 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.
This page was last updated: June 14, 2022