AppsFlyer

Why combine AppsFlyer and Purchasely?
Pre-requisites
The minimal version of the Purchasely SDK supporting this integration is v3.2.0. If the Purchasely SDK integrated in your app is under the minimal version, please update it.
The AppsFyer SDK also needs to be integrated inside the app.
Subscription events
General overview
​Appsflyer is one of the leading MMP (Mobile Measurement Partner): a third-party attribution company that collects, organizes, and presents data from marketing campaigns in order to provide brands with a unified view of their campaign performance
This integration will allow you to track your subscriptions and in-app purchases events in your AppsFlyer Dashboard.
Purchasely provides a unified dataset to track the subscription events for all stores. These events are generated by the Purchasely Backend and can be sent to AppsFlyer.
Subscription events generated by Purchasely will be sent to AppsFlyer using a server-to-server integration. As a result, you will be able to see all the subscription events in your AppsFlyer Dashboard and map them with your acquisition campaigns.
The following events can be sent from Purchasely to AppsFlyer to associate them to your campaigns. You can find the full list here.
Event
Description
SUBSCRIPTION_STARTED
Sent when the user purchased a product wether it is the start of a trial or a regular purchase of a consumable product.
SUBSCRIPTION_RENEWED
Sent when a subscription renews
TRIAL_STARTED
Sent when a trial starts
TRIAL_CONVERTED
Sent when a user converts from a free trial to a normal paid-period
TRIAL_NOT_CONVERTED
Sent when a user finishes it's trial period without renewing to a paid-periodYou can also override an event's token for each store, individually, provided you h
PURCHASE_VALIDATED
Sent when a user purchases a one-time purchase (consumable or not consumable)
SUBSCRIPTION_REACTIVATED
Sent when an expired subscription is reactivated. This event is particularly useful for win-back & retargeting campaigns
SUBSCRIPTION_REFUNDED_REVOKED
Sent when a subscription is refunded
Integrating Purchasely with AppsFlyer
The integration requires 2 steps:
1.Associate the user to events by providing the AppsFlyer ID to the Purchasely SDK
2.Activate the AppsFlyer integration in the Purchasely Console
1. Associating users to events
See iOS or Android Appsflyer documentation for more information
Swift
Kotlin
Java
React Native
Cordova
Flutter
Purchasely.setAttribute(.appsflyerId, value: AppsFlyerLib.shared().getAppsFlyerUID())
AppsFlyerLib.getInstance().getAppsFlyerUID(applicationContext)?.let {
    Purchasely.setAttribute(Attribute.APPSFLYER_ID, it)
}
Purchasely.setAttribute(
	Attribute.APPSFLYER_ID,
	AppsFlyerLib.getInstance().getAppsFlyerUID(this)
);
appsFlyer.getAppsFlyerUID((err, appsFlyerUID) => {
  if (err) {
    console.error(err);
  } else {
    Purchasely.setAttribute(Attributes.APPSFLYER_ID, appsFlyerUID);
  }
});
var  getUserIdCallbackFn = function(id) {
alert('received id is: ' + id);
}
​
var appsFlyerId = window.plugins.appsFlyer.getAppsFlyerUID(getUserIdCallbackFn);
​
Purchasely.setAttribute(Purchasely.Attribute.APPSFLYER_ID, appsFlyerId);
appsFlyerSdk.getAppsFlyerUID().then((AppsFlyerId) {
  Purchasely.setAttribute(PLYAttribute.appsflyer_id,AppsFlyerId);
});
2. Activating the AppsFlyer integration
The activation requires 3 steps:
1.Retrieving your app id in the AppsFlyer Dashboard (iOS and / or Android)
2.Retrieving your API key in the AppsFlyer Dashboard (iOS and / or Android)
3.Enabling the AppsFlyer integration in the Purchasely Console
a. Retrieving your app id in the AppsFlyer Dashboard
1.Go to your AppsFlyer dashboard: https://hq1.appsflyer.com/apps/myapps
2.You will find your app's ids beneath their names
b. Retrieving your API key in the AppsFlyer Dashboard
1.Go to your AppsFlyer dashboard: https://hq1.appsflyer.com/apps/myapps​
2.Using the app's top right menu, access your app's settings
3. You will find your app's API key at the top of the page
4. (optional) repeat for your Android / iOS app
c. Enabling the AppsFlyer integration in the Purchasely Console
1. Visit your Purchasely app's console​
2. Access your apps Integrations' settings
3. Access the AppsFlyer Integration's Settings
4. Enable the AppsFlyer integration
5. (iOS) Set your iOS AppsFlyer app's API key & app ID
6. (Android) Set your Android AppsFlyer app's API key & App ID
7. (optional) Override the name of events sent to AppsFlyer
8. Save
Testing your integration
To test your integration, you can perform a set of in-app purchases in a Sandbox environment (eg: TestFlight for the App Store).
Bear in mind that events can take up to 24 hours to show up in your AppsFlyer dashboard.

Event	Description
SUBSCRIPTION_STARTED	Sent when the user purchased a product wether it is the start of a trial or a regular purchase of a consumable product.
SUBSCRIPTION_RENEWED	Sent when a subscription renews
TRIAL_STARTED	Sent when a trial starts
TRIAL_CONVERTED	Sent when a user converts from a free trial to a normal paid-period
TRIAL_NOT_CONVERTED	Sent when a user finishes it's trial period without renewing to a paid-periodYou can also override an event's token for each store, individually, provided you h
PURCHASE_VALIDATED	Sent when a user purchases a one-time purchase (consumable or not consumable)
SUBSCRIPTION_REACTIVATED	Sent when an expired subscription is reactivated. This event is particularly useful for win-back & retargeting campaigns
SUBSCRIPTION_REFUNDED_REVOKED	Sent when a subscription is refunded

Last modified 28d ago