구글 애널리틱스 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

Java

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

Kotlin

// 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

Swift

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

TypeScript

import analytics from '@react-native-firebase/analytics';

TypeScript

const appInstanceId = await analytics().getAppInstanceId();
Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);
Airbirdge.state.startTracking();

🚧

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

연동하기 - Flutter

Dart

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_analytics/firebase_analytics.dart';

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

C#

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