Amplitude integration with AppsFlyer

About the integration

Amplitude, an AppsFlyer integrated partner, is a product analytics platform used by product, growth, and marketing teams to understand user behavior across mobile and web. The integration allows AppsFlyer to send key event data to Amplitude post-install, enabling comprehensive user-level analysis.

There are two Amplitude integration versions:

• Amplitude V1:
  This version uses Amplitude’s Attribution API. AppsFlyer sends install data collected after the integration is complete. Amplitude uses Ad ID as the identifier and discards the data if no matching user event is logged within 72 hours. Learn more
• Amplitude V2 :
  This version uses Amplitude’s HTTP V2 API. AppsFlyer sends both installs and in-app event data after the integration is complete. Identifiers are prioritized (user_id and device_id), and if matching fails, a new user is logged. Learn more

Integration versions:

Prerequisites

Before you begin:

• Contact Amplitude to create an account if you don't already have one.
• Decide whether you will set up the Amplitude V1 or V2 integration.
• Make sure you avoid sending the same events from both the Amplitude SDK and AppsFlyer to prevent duplication.
• See the additional prerequisite for the Amplitude V2 integration.

Additional prerequisites for the Amplitude V2 integration

The V2 integration requires setup of the:

• Amplitude device ID
• Customer user ID
• Amplitude session ID

Amplitude device ID

To enable user-level attribution, you must pass the Amplitude Device ID into the AppsFlyer SDK. This value is sent with each postback.

AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())

[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];

AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]

Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId());
AppsFlyer.setAdditionalData(customData);

appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);

appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});

var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);

Customer user ID

Set up the Customer User ID (CUID). This is a unique identifier typically generated and set
by the app owner during user registration. Learn more

Amplitude session ID

Set up the Amplitude session ID and pass it to AppsFlyer. Learn more

AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())

[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];

AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]

Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId());
AppsFlyer.setAdditionalData(customData);

appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);

appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});

var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);

Set up the integration

To set up the integration:

1. In AppsFlyer, go to Collaborate > Partner Marketplace.
2. To set up the Amplitude V1 integration, select Amplitude V1 (Tech partner).
   
   
   
   
   To set up the Amplitude V2 integration, select Amplitude V2 (Tech partner). 
   
   
   
    
3. Once you've selected your Amplitude version, click Set up integration.
   
   
    
4. In the Integration tab:
   • Select your app.
   • Turn on the Activate partner toggle.
     
     
     
      
5. Complete the configuration in the remaining tabs:

Viewing attribution data in the Amplitude console

Attribution data sent from AppsFlyer to Amplitude is displayed in your dashboards as events and properties prefixed with [AppsFlyer]:

Sending Amplitude events to AppsFlyer

The integration also allows sending your Amplitude events to AppsFlyer via a Server-to-server API. See Amplitude documentation on how to do this.