Google Analytics 4 (GA4)

    Airbridge 支持与 Google Analytics 4 (GA4) 的集成。Airbridge 客户可以在 GA4 利用 Airbridge 的广告绩效数据对产品进行更精细的分析。

    提示

    只有已在 GA4 注册的 App 才能与 Airbridge 集成。

    集成方法

    通过将 Firebase Analytics SDK 的 App Instance ID 指定为 Airbridge SDK 的设备别名 (Device Alias)，将 Airbridge SDK 收集的数据发送至 GA4 服务器。

    支持的 SDK

    以下版本及以上的 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 设置后，请确保在 Airbridge 面板中完成必要的设置，以成功完成集成。

    请将以下代码插入 Airbridge SDK。如果未完成 Airbridge SDK 的相关设置，即使在 Airbridge 面板中完成了集成设置，Airbridge 和 GA4 也无法正常集成。

    Android

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

    iOS

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

    React Native

    需要在 airbridge.json 文件中，将 autoStartTrackingEnabled 选项设置为 false。

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

    Flutter

    需要在 airbridge.json 文件中，将 autoStartTrackingEnabled 选项设置为 false。

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

    Unity

    需要在 Project 设置 中，将 autoStartTrackingEnabled 选项设置为 false。

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

    Airbridge 面板设置

    完成 SDK 设置后，还需在 Airbridge 面板中完成必要的设置，才能完成所有集成设置。有关更多信息，请参阅用户指南：

    Was this helpful?

    Any questions or suggestions?