에어브릿지는 구글 애널리틱스 4(Google Analytics 4, GA4) 연동을 지원합니다. 에어브릿지 사용자는 GA4에서 에어브릿지의 광고 성과 데이터로 더 정교하게 프로덕트를 분석할 수 있습니다.
알립니다
GA4에 등록된 앱만 에어브릿지와 연동할 수 있습니다.
Firebase Analytics SDK의 App Instance ID를 에어브릿지 SDK의 디바이스 알리아스(Device Alias)로 지정하는 방식으로 에어브릿지 SDK로 수집되는 데이터를 구글 애널리틱스 4(GA4) 서버로 전송합니다.
아래 버전 이상의 SDK에서 GA4 연동을 지원합니다.
Airbridge Android SDK: 2.19.5
Airbridge iOS SDK: 1.18.0
Airbridge React Native SDK: 1.5.0
Airbridge Flutter SDK: 3.0.2
Airbridge Unity SDK: 1.9.0
주의하세요
연동을 마치기 위해서는 에어브릿지 대시보드 설정이 필요합니다. SDK 설정 이후에 반드시 필요한 모든 설정을 진행해 주세요.
에어브릿지 SDK에 아래 코드를 삽입합니다. 에어브릿지 SDK 작업을 하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 GA4가 정상적으로 연동되지 않습니다.
// 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
FirebaseAnalytics.getInstance(this).getAppInstanceId()
.addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
String appInstanceId = task.getResult();
if (appInstanceId != null) {
Airbridge.setDeviceAlias("ga4_app_instance_id", appInstanceId);
}
// 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")
// Make Airbridge SDK explicitly start tracking
.setAutoStartTrackingEnabled(false)
.build()
Airbridge.init(this, config)
// Set device alias into Airbridge SDK
Firebase.analytics.appInstanceId.addOnCompleteListener { task ->
val appInstanceId: String? = task.result
if (appInstanceId != null) {
Airbridge.setDeviceAlias("ga4_app_instance_id", appInstanceId)
}
// Explicitly start tracking
Airbridge.startTracking()
}
}import FirebaseAnalytics
// AppDelegate.swift
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?
) {
AirBridge.setAutoStartTrackingEnabled(false)
AirBridge.getInstance("YOUR_APP_SDK_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)
if let appInstanceID = Analytics.appInstanceID() {
AirBridge.state()?.setDeviceAlias(key:"ga4_app_instance_id", value: appInstanceID)
}
// Explicitly start tracking
AirBridge.startTracking()
}airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
import analytics from '@react-native-firebase/analytics';const appInstanceId = await analytics().getAppInstanceId();
Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);
Airbirdge.state.startTracking();airbridge.json의 autoStartTrackingEnabled 옵션을 false로 설정해야 합니다.
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_analytics/firebase_analytics.dart';final appInstanceId = await FirebaseAnalytics.instance.appInstanceId;
if (appInstanceId != null) {
Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);
}
Airbridge.state.startTracking();프로젝트 설정의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.
private async void SetupAirbridgeIntegration()
{
#if UNITY_ANDROID || UNITY_IOS
string appInstanceId = await Firebase.Analytics.FirebaseAnalytics.GetAnalyticsInstanceIdAsync();
AirbridgeUnity.SetDeviceAlias("ga4_app_instance_id", appInstanceId);
// ... (에어브릿지 연동 코드를 여기에 추가해주세요)
#endif
AirbridgeUnity.StartTracking();
}SDK 작업을 마친 후에 에어브릿지 대시보드에서 필요한 작업을 마쳐야 모든 연동 과정이 마무리됩니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
도움이 되었나요?