Amplitude V2

Airbridge supports integration with Amplitude. With the integration, you can send attribution data from Airbridge to Amplitude and uncover insights into how users interact with your product in Amplitude.

This article outlines the V2 integration method, which uses Amplitude's HTTP V2 API.

Once the integration is complete, the event data, including Target Events, is sent to Amplitude as Event Properties and User Properties.

Integration

To implement the server-to-server integration, the Device ID of the Amplitude SDK should be set as the device alias of the Airbridge SDK.

Minimum SDK version required

  • Airbridge Android SDK: v.2.19.5

  • Airbridge iOS SDK: v.1.18.0

  • Airbridge Web SDK Loader: v.1.3.0

  • Airbridge React Native SDK: v.1.5.0

  • Airbridge Cordova SDK: v.2.0.2

  • Airbridge Flutter SDK: v.3.0.2

  • Airbridge Unity SDK: v.1.9.0

SDK setup

Attention

Once the SDK setup is complete, make sure to complete the required setup process in the Airbridge dashboard to implement the integration successfully.

Add the codes below to the Airbridge SDK. Without adding the codes, Amplitude won't be properly integrated with Airbridge even if the necessary setup is completed in the Airbridge dashboard.

Android SDK (v4)

123456789101112131415
// MainApplication.kt
override fun onCreate() {
    super.onCreate()
    // Initialize Airbridge SDK
    val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.initializeSDK(this, option)

    // Set device alias into Airbridge SDK
    Airbridge.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId())
    
    // Explicitly start tracking
    Airbridge.startTracking()
}
12345678910111213141516
// MainApplication.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeOption option = new AirbridgeOptionBuilder("APP_NAME", "APP_TOKEN")
        .setAutoStartTrackingEnabled(false)
        .build();
    Airbridge.initializeSDK(application, option);
    
    // Set device alias into Airbridge SDK
    Airbridge.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId());
    
    // Explicitly start tracking
    Airbridge.startTracking();
}

Android SDK (Previous)

123456789101112131415
// MainApplication.kt
override fun onCreate() {
    super.onCreate()
    // Initialize Airbridge SDK
    val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.init(this, config)

    // Set device alias into Airbridge SDK
    Airbridge.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId())
    
    // Explicitly start tracking
    Airbridge.startTracking()
}
12345678910111213141516
// MainApplication.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
        .setAutoStartTrackingEnabled(false)
        .build();
    Airbridge.init(this, config);
    
    // Set device alias into Airbridge SDK
    Airbridge.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId());

    // Explicitly start tracking
    Airbridge.startTracking();
}

iOS SDK (v4)

123456789101112131415161718
// AppDelegate.swift
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {

    let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.initializeSDK(option: option)

    Airbridge.setDeviceAlias(key: "amplitude_device_id", value: Amplitude.instance().deviceId())
    
    // Explicitly start tracking
    Airbridge.startTracking()

    return true
}
12345678910111213141516171819
// AppDelegate.m
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    AirbridgeOptionBuilder* optionBuilder = 
        [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                               token:@"YOUR_APP_SDK_TOKEN"];

    [optionBuilder setAutoStartTrackingEnabled:NO];
    AirbridgeOption* option = [optionBuilder build];
    [Airbridge initializeSDKWithOption:option];

    [Airbridge setDeviceAliasWithKey:@"amplitude_device_id" 
                               value:Amplitude.instance.deviceId];
    
    // Explicitly start tracking
    [Airbridge startTracking];

    return YES;
}

iOS SDK (Previous)

12345678910111213141516
// AppDelegate.swift
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
  
    AirBridge.setAutoStartTrackingEnabled(false)
    AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

    AirBridge.state()?.setDeviceAlias(withKey:"amplitude_device_id", value:Amplitude.instance().deviceId())
    
    // Explicitly start tracking
    AirBridge.startTracking()

    return true
}
12345678910111213141516
// AppDelegate.m
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    AirBridge.autoStartTrackingEnabled = NO;
    [AirBridge getInstance:@"YOUR_APP_SDK_TOKEN"
                   appName:@"YOUR_APP_NAME"
         withLaunchOptions:launchOptions];

    [AirBridge.state setDeviceAliasWithKey: @"amplitude_device_id"
                                     value: Amplitude.instance.deviceId];

    // Explicitly start tracking
    [AirBridge startTracking];

    return YES;
}

123456
airbridge.init({
  ...
  autoStartTrackingEnabled: false,
})
airbridge.setDeviceAlias('amplitude_device_id', Amplitude.getInstance().getDeviceId())
airbridge.startTracking()

React Native SDK (v4)

Set autoStartTrackingEnabled to false in the airbridge.json.

12345
await Amplitude.init(...);

const appInstanceId = await Amplitude.getDeviceId();
Airbridge.setDeviceAlias("amplitude_device_id", appInstanceId);
Airbridge.startTracking();

React Native SDK (Previous)

Set autoStartTrackingEnabled to false in the airbridge.json.

1234
await Amplitude.init(...)

Airbridge.state.setDeviceAlias("amplitude_device_id", await Amplitude.getDeviceId())
Airbridge.state.startTracking()

Set autoStartTrackingEnabled to false in the airbridge.json.

12
Airbridge.state.setDeviceAlias("amplitude_device_id", amplitude.getDeviceId())
Airbridge.state.startTracking()

Flutter SDK (v4)

Set autoStartTrackingEnabled to false in the airbridge.json.

123
final appInstanceId = Amplitude.getInstance().getDeviceId();
Airbridge.setDeviceAlias("amplitude_device_id", appInstanceId);
Airbridge.startTracking();

Flutter SDK (Previous)

Set autoStartTrackingEnabled to false in the airbridge.json.

12
Airbridge.state.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId())
Airbridge.state.startTracking()

Unity SDK (v4)

Set Auto Start Tracking Enabled to false in the project settings.

123
string DeviceID = Amplitude.getInstance().getDeviceId();
Airbridge.SetDeviceAlias("amplitude_device_id", DeviceID);
Airbridge.StartTracking();

Unity SDK (Previous)

Set Auto Start Tracking Enabled to false in the project settings.

123
string DeviceID = Amplitude.getInstance().getDeviceId();
AirbridgeUnity.SetDeviceAlias("amplitude_device_id", DeviceID);
AirbridgeUnity.StartTracking();

Airbridge dashboard setup

The Airbridge dashboard setup must be completed to implement the integration. For detailed instructions, refer to the user guide below.