AppsFlyer

AppsFlyer is a leading platform for mobile attribution and marketing analytics. It stands as a third-party service that gathers and organizes data from marketing campaigns. This helps companies see how well their campaigns are performing in one place.

Adapty provides a complete set of data that lets you track subscription events from stores in one place. With Adapty, you can easily see how your subscribers are behaving, learn what they like, and use that information to communicate with them in a way that's targeted and effective. Therefore, this integration allows you to track subscription events in AppsFlyer and analyze precisely how much revenue your campaigns generate.

The integration between Adapty and AppsFlyer operates in two main ways.

1. Receiving attribution data from AppsFlyer
   Once you've set up sending Appsflyer attribution to Adapty in your app code, Adapty will start receiving attribution data from AppsFlyer. You can easily access and view this data on the user's profile page.

2. Sending subscription events to AppsFlyer
   Adapty can send all subscription events that are configured in your integration to AppsFlyer. As a result, you'll be able to track these events within the AppsFlyer dashboard. This integration is beneficial for evaluating the effectiveness of your advertising campaigns.

How to set up AppsFlyer integration

To setup the integration with AppsFlyer:

1. Open Integrations -> AppsFlyer in the Adapty Dashboard.

2. Turn on the toggle to enable the integration.

3. The next step of the integration is to set credentials. For iOS, find App ID in the copy Apple ID in the App Store Connect (to do it, open your app page in App Store Connect, go to the App Information page in General section, and find Apple ID in the left bottom part of the screen).

3.2. Paste the copied Apple ID to the iOS App ID in the Adapty Dashboard.

warning

If you use AppsFlyer API 2, you need to switch to API 3, since the previous version will be deprecated by AppsFlyer soon. To do so, in the AppsFlyer S2S API list, select API 3.

5. For both iOS and Android, open the AppsFlyer site and log in.

6. Click Your account name -> Security Center in the top-right corner of the dashboard.

7. In the Manage your account security window, click the Manage your AppsFlyer API and S2S tokens button.

8. If you have an S2S token, please proceed to step 12. If you do not have it, click the New token button.

9. In the New token window, enter the name of the token. This name is solely for your reference.

10. Choose S2S in the Choose type list.

11. Click the Create new token button to save the new token.

12. In the Tokens window, copy the S2S token.

13. In the Adapty Dashboard, paste the copied S2S key into the Dev key for iOS and Dev key for Android fields.

14. Click the Save button to save the changes.

    info

    AppsFlyer doesn't have a Sandbox mode for server2server integration. So you need a different application/account in AppsFlyer for Sandbox Dev Key. If you want to send sandbox events to the same app, just use the same key for production and sandbox.

Adapty maps some events to AppsFlyer standard events by default. With such a configuration, AppsFlyer can then forward events to each ad network that you use without additional setup.

Another important thing is that AppsFlyer doesn't support events older than 24 hours. So, if you have an event that is more than a day old, Adapty will send it to Appsflyer, but the event date and time will be replaced by the current timestamp.

Events and tags

Below the credentials, there are three groups of events you can send to AppsFlyer from Adapty. Simply turn on the ones you need. Check the full list of the events offered by Adapty here.

We recommend using the default event names provided by Adapty. But you can change the event names based on your needs.

Adapty will send subscription events to AppsFlyer using a server-to-server integration, allowing you to view all subscription events in your AppsFlyer dashboard and link them to your acquisition campaigns.

SDK configuration

It's very important to send AppsFlyer attribution data from the device to Adapty using the Adapty.updateAttribution() SDK method and the Adapty.setIntegrationIdentifier() method to set the integration identifier. The example below shows how to do that.

iOS (Swift)

class YourAppsFlyerLibDelegateImplementation {
    // Find your implementation of AppsFlyerLibDelegate 
    // and update onConversionDataSuccess method:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
        Adapty.updateAttribution(conversionInfo, source: "appsflyer")
    }
}

Android (Kotlin)

val conversionListener: AppsFlyerConversionListener = object : AppsFlyerConversionListener {
    override fun onConversionDataSuccess(conversionData: Map<String, Any>) {
        // It's important to include the network user ID
        Adapty.updateAttribution(
            conversionData,
            AdaptyAttributionSource.APPSFLYER,
            AppsFlyerLib.getInstance().getAppsFlyerUID(context)
        ) { error ->
            if (error != null) {
                //handle error
            }
        }
    }
}

Flutter (Dart)

import 'package:appsflyer_sdk/appsflyer_sdk.dart';

AppsflyerSdk appsflyerSdk = AppsflyerSdk(<YOUR_OPTIONS>);
appsflyerSdk.onInstallConversionData((data) async {
    try {
        // It's important to include the network user ID
        final appsFlyerUID = await appsFlyerSdk.getAppsFlyerUID();
        await Adapty().updateAttribution(
          data,
          source: AdaptyAttributionSource.appsflyer,
          networkUserId: appsFlyerUID,
        );
    } on AdaptyError catch (adaptyError) {
        // handle error
    } catch (e) {}
});

appsflyerSdk.initSdk(
    registerConversionDataCallback: true,
    registerOnAppOpenAttributionCallback: true,
    registerOnDeepLinkingCallback: true,
);

Unity (C#)

using AppsFlyerSDK;

// before SDK initialization
AppsFlyer.getConversionData(this.name);

// in your IAppsFlyerConversionData
void onConversionDataSuccess(string conversionData) {
    // It's important to include the network user ID
    string appsFlyerId = AppsFlyer.getAppsFlyerId();
    Adapty.UpdateAttribution(conversionData, AttributionSource.Appsflyer, appsFlyerId, (error) => {
        // handle the error
    });
}

React Native (TS)

import { adapty, AttributionSource } from 'react-native-adapty';
import appsFlyer from 'react-native-appsflyer';

appsFlyer.onInstallConversionData(installData => {
    try {
        // It's important to include the network user ID
        const networkUserId = appsFlyer.getAppsFlyerUID();
        adapty.updateAttribution(installData, AttributionSource.AppsFlyer, networkUserId);
    } catch (error) {
        // handle error
    }
});

// ...
appsFlyer.initSdk(/*...*/);