앰플리튜드(Amplitude) 연동 V2 방식은 앰플리튜드에서 제공하는 HTTP V2 API를 통해 이뤄집니다.
연동이 정상적으로 완료되면 에어브릿지는 연동 이후에 발생하는 타겟 이벤트를 포함한 다른 이벤트와 이벤트의 프로퍼티 같은 광고 성과 데이터를 앰플리튜드로 전송합니다. 앰플리튜드는 에어브릿지에서 전송하는 프로퍼티를 이벤트 프로퍼티(Event Properties)와 유저 프로퍼티(User Properties)에 추가합니다.
앰플리튜드 SDK의 디바이스 ID를 에어브릿지 SDK의 디바이스 알리아스(Device Alias)로 지정하는 방식으로 에어브릿지 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 작업을 하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 앰플리튜드가 정상적으로 연동되지 않습니다.
// 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()
}// 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();
}// 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()
}// 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();
}// 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
}// 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;
}// 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
}// 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;
}airbridge.init({
...
autoStartTrackingEnabled: false,
})
airbridge.setDeviceAlias('amplitude_device_id', Amplitude.getInstance().getDeviceId())
airbridge.startTracking()airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
await Amplitude.init(...);
const appInstanceId = await Amplitude.getDeviceId();
Airbridge.setDeviceAlias("amplitude_device_id", appInstanceId);
Airbridge.startTracking();airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
await Amplitude.init(...)
Airbridge.state.setDeviceAlias("amplitude_device_id", await Amplitude.getDeviceId())
Airbridge.state.startTracking()airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
Airbridge.state.setDeviceAlias("amplitude_device_id", amplitude.getDeviceId())
Airbridge.state.startTracking()airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
final appInstanceId = Amplitude.getInstance().getDeviceId();
Airbridge.setDeviceAlias("amplitude_device_id", appInstanceId);
Airbridge.startTracking();airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
Airbridge.state.setDeviceAlias("amplitude_device_id", Amplitude.getInstance().getDeviceId())
Airbridge.state.startTracking()프로젝트 설정의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.
string DeviceID = Amplitude.getInstance().getDeviceId();
Airbridge.SetDeviceAlias("amplitude_device_id", DeviceID);
Airbridge.StartTracking();프로젝트 설정의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.
string DeviceID = Amplitude.getInstance().getDeviceId();
AirbridgeUnity.SetDeviceAlias("amplitude_device_id", DeviceID);
AirbridgeUnity.StartTracking();SDK 작업을 마친 후에 에어브릿지 대시보드에서 필요한 작업을 마쳐야 모든 연동 과정이 마무리됩니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
도움이 되었나요?