AppsFlyer
Last updated
Last updated
AppsFlyer is the market leader in mobile advertising attribution and analytics, helping marketers to pinpoint their targeting, optimize their ad spend and boost their ROI (Return on Investment).
AppsFlyer allows users to monitor and track application installations, downloads, and conversions. The AppsFlyer API allows developers to access and integrate the functionality of AppsFlyer with other applications.
In order to enable AppsFlyer to start tracking your app, you are required to have the following two information such as:
devKey
: Your application devKey provided by AppsFlyer.
appId
: (For iOS only) Your iOS app ID in the App Store.
For Monaca Cloud IDE, go to Configure → Service Integration Settings
.
Click on Details
button of AppsFlyer service.
Then, click Install
button to add it into your project.
4. You will be asked to confirm the setup. Click to start the installation.
Add the following lines to your code to initialize the tracking with your own AppsFlyer devKey
and appId
:
Initialize the SDK.
Parameter
Name
Type
Description
options
Object
SDK configuration (please refer to the options object table below)
onSuccess
(message
: string) => void
(optional) Success callback: called after a successful SDK initialization.
onError
(message
: string) => void
(optional) Error callback: called when error occurs during initialization.
options object
Name
Type
Default
Description
appId
String
(For iOS only) Your iOS app ID in the App Store
isDebug
Boolean
false
(optional) Debug mode
onInstallConversionDataListener
Boolean
false
Accessing AppsFlyer Attribution/Conversion Data from the SDK (Deferred Deeplinking). AppsFlyer plugin will return attribution data in onSuccess callback. For more information, please refer to:
Example
The following snippet shows how to use initSdk()
function:
Allow you to send in-app events to AppsFlyer analytics. This method allows you to add events dynamically by adding them directly to the application code. These in-app events help you track how loyal users discover your app, and attribute them to specific campaigns/media-sources. Please take the time to define the event(s) you want to measure to allow you to track ROI (Return on Investment) and LTV (Lifetime Value).
Parameter
Name
Type
Description
eventName
String
Custom event name, is presented in your dashboard.
eventValue
Object
Event details
Example
The following snippet shows how to use trackEvent()
function:
Change the currency code.
Parameter
Name
Type
Default
Description
Example
The following snippet shows how to use setCurrencyCode()
function:
Set your own custom ID. This enables you to cross-reference your own unique ID with AppsFlyer’s user ID and the other devices’ IDs. This ID is available in AppsFlyer CSV reports along with postbacks APIs for cross-referencing with you internal IDs.
The ID must be set during the first launch of the app at the SDK initialization. The best practice is to call this API during the deviceready
event, where possible.
Parameter
Name
Type
Description
customerUserId
String
Your custom ID
Example
The following snippet shows how to use setAppUserId()
function:
Set a GCM Project Number in order to enable app uninstall tracking for Android platform.
Parameter
Name
Type
Description
GCMProjectNumber
String
GCM Project number. It is obtained through your google developer console. For more information, please refer to Android Uninstall Measurement.
Set your iOS device token in order to enable app uninstall tracking for iOS platform.
Parameter
Name
Type
Description
token
String
Your iOS device token. You can get your device token from UnityEngine.iOS.NotificationServices.deviceToken
. For more information, please refer to Unity and iOS Uninstall Measurement.
Get AppsFlyer’s proprietary Device ID. The AppsFlyer Device ID is the main ID used by AppsFlyer in Reports and APIs.
Parameter
Name
Type
Description
getUserIdCallbackFn
() => void
Success callback
Example
The following snippet shows how to use getAppsFlyerUID()
function:
Track deeplinks with AppsFlyer attribution data (for iOS only).
For Android version 4.2.5 and higher, the deeplinking metadata (scheme/host) is sent automatically.
Parameter
Name
Type
Description
url
String
Url
Example
The following snippet shows how to use handleOpenUrl()
function: