User GuideDeveloper GuideAPI
Dashboard

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

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_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。

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

Airbridge 面板设置

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

Was this page helpful?

Have any questions or suggestions?