AppsFlyer App Events Connector Setup Guide | Server-Side Connectors

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: - 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

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	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.