유저 가이드개발자 가이드API
대시보드

앰플리튜드 (V2)

앰플리튜드(Amplitude) 연동 V2 방식은 앰플리튜드에서 제공하는 HTTP V2 API를 통해 이뤄집니다.

연동이 정상적으로 완료되면 에어브릿지는 연동 이후에 발생하는 타겟 이벤트를 포함한 다른 이벤트와 이벤트의 프로퍼티 같은 광고 성과 데이터를 앰플리튜드로 전송합니다. 앰플리튜드는 에어브릿지에서 전송하는 프로퍼티를 이벤트 프로퍼티(Event Properties)와 유저 프로퍼티(User Properties)에 추가합니다.

V2 방식으로 연동하기

앰플리튜드 SDK의 디바이스 ID를 에어브릿지 SDK의 디바이스 알리아스(Device Alias)로 지정하는 방식으로 에어브릿지 SDK로 수집되는 데이터를 앰플리튜드 서버로 전송합니다.

지원하는 SDK

아래 버전 이상의 SDK에서 앰플리튜드 V2 연동을 지원합니다.

  • Airbridge Android SDK: 2.19.5

  • Airbridge iOS SDK: 1.18.0

  • Airbridge Web SDK Loader: 1.3.0

  • Airbridge React Native SDK: 1.5.0

  • Airbridge Cordova SDK: 2.0.2

  • Airbridge Flutter SDK: 3.0.2

  • Airbridge Unity SDK: 1.9.0

사전 준비사항

주의하세요

연동을 마치기 위해서는 에어브릿지 대시보드 설정이 필요합니다. SDK 설정 이후에 반드시 필요한 모든 설정을 진행해 주세요.

에어브릿지 SDK에 아래 코드를 삽입합니다. 에어브릿지 SDK 작업을 하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 앰플리튜드가 정상적으로 연동되지 않습니다.

Android

12345678910111213141516
// MainApplication.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .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

1234567891011
// AppDelegate.swift
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?
) {
    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())
    AirBridge.startTracking()
}

Web

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

React Native

airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.

1234
await Amplitude.init(...)

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

Cordova

airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.

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

Flutter

airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.

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

Unity

프로젝트 설정의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.

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

에어브릿지에서 앰플리튜드 연동하기

SDK 작업을 마친 후에 에어브릿지 대시보드에서 필요한 작업을 마쳐야 모든 연동 과정이 마무리됩니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

도움이 되었나요?

더 필요한 내용이 있나요?