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

구글 애널리틱스 4 연동

에어브릿지는 구글 애널리틱스 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

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

연동하기 - iOS

1234567891011121314151617
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

1
import analytics from '@react-native-firebase/analytics';
123
const appInstanceId = await analytics().getAppInstanceId();
Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);
Airbirdge.state.startTracking();

주의하세요

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

연동하기 - Flutter

12
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_analytics/firebase_analytics.dart';
1234567
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

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

도움이 되었나요?

더 필요한 내용이 있나요?