구글 애널리틱스 4(GA4) 연동

에어브릿지는 구글 애널리틱스 4(Google Analytics 4, GA4) 연동을 지원합니다. 연동을 완료하면 에어브릿지에 쌓이는 타겟 이벤트와 각 이벤트의 주요 어트리뷰션 데이터가 구글 애널리틱스로 전송됩니다. 에어브릿지 사용자는 구글 애널리틱스에서 에어브릿지의 광고 성과 데이터를 활용해서 더 정교하게 프로덕트를 분석할 수 있습니다.

에어브릿지 ↔ GA4 연동

에어브릿지와 GA4 연동작업은 Firebase Analytics SDK의 App Instance ID를 에어브릿지 SDK의 Device Alias로 지정하는 것으로 에어브릿지 SDK로 수집되는 이벤트 정보, Attribution 정보를 GA4 의 서버로 Server to Server 연동하는 방식으로 이루어집니다.

최소 SDK 지원 버전

  • 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

연동하기 - Android

// 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 -> task.result?.let { app_instance_id -> Airbridge.setDeviceAlias("ga4_app_instance_id", app_instance_id) } } // Explicitly start tracking Airbridge.startTracking() }

연동하기 - iOS

import FirebaseAnalytics // 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) if let appInstanceID = Analytics.appInstanceID() { AirBridge.state()?.setDeviceAlias(key:"ga4_app_instance_id", value: appInstanceID) } // Explicitly start tracking AirBridge.startTracking() }

연동하기 - React Native

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 로 설정하세요.

연동하기 - Flutter

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();

🚧

연동을 위해 airbridge.json의 autoStartTrackingEnabled 옵션을 false 로 설정하세요.

연동하기 - Unity

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(); }

🚧

연동을 위해 프로젝트 설정Auto Start Tracking Enabled 옵션을 false 로 설정하세요.