> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics 4 (GA4)

Airbridge supports integration with Google Analytics 4 (GA4). With the integration, you can send attribution data from Airbridge to GA4 and uncover insights into how users interact with your product in GA4.

<Info>
  **Note**

  Only apps registered with GA4 can be integrated with Airbridge.
</Info>

## Integration

To implement the server-to-server integration, the App Instance ID of the Firebase Analytics SDK should be set as the device alias of the Airbridge SDK.

### Minimum SDK version required

* Airbridge Android SDK: v.2.19.5
* Airbridge iOS SDK: v.1.18.0
* Airbridge React Native SDK: v.1.5.0
* Airbridge Flutter SDK: v.3.0.2
* Airbridge Unity SDK: v.1.9.0

### SDK setup

<Danger>
  **Attention**

  Once the SDK setup is complete, make sure to complete the required setup process in the Airbridge dashboard to implement the integration successfully.
</Danger>

Add the codes below to the Airbridge SDK. Without adding the codes, GA4 won't be properly integrated with Airbridge even if the necessary setup is completed in the Airbridge dashboard.

<AccordionGroup>
  <Accordion title="SDK integration (Android)">
    #### Android SDK

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.kt
      override fun onCreate() {
          super.onCreate()
          // Initialize Airbridge SDK
          val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(this, option)

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

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeOption option = new AirbridgeOptionBuilder("APP_NAME", "APP_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build();
          Airbridge.initializeSDK(application, option);

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

    #### Android SDK (Deprecated)

    <CodeGroup>
      ```kotlin Kotlin lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // 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()
          }
      }
      ```

      ```java Java lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      // MainApplication.java
      @Override
      public void onCreate() {
          super.onCreate();
          // Initialize Airbridge SDK
          AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
              .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();
                  }
              });
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK integration (iOS)">
    #### iOS SDK

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      import FirebaseAnalytics

      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {

          let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
              .setAutoStartTrackingEnabled(false)
              .build()
          Airbridge.initializeSDK(option: option)

          if let appInstanceID = Analytics.appInstanceID() {
              Airbridge.setDeviceAlias(key: "ga4_app_instance_id", value: appInstanceID)
          }
          
          // Explicitly start tracking
          Airbridge.startTracking()

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      @import FirebaseAnalytics;

      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirbridgeOptionBuilder* optionBuilder = 
              [[AirbridgeOptionBuilder alloc] initWithName:@"YOUR_APP_NAME"
                                                     token:@"YOUR_APP_SDK_TOKEN"];

          [optionBuilder setAutoStartTrackingEnabled:NO];
          AirbridgeOption* option = [optionBuilder build];
          [Airbridge initializeSDKWithOption:option];

          NSString *appInstanceID = [FIRAnalytics appInstanceID];
          if (appInstanceID) {
              [Airbridge setDeviceAliasWithKey:@"ga4_app_instance_id" 
                                         value:appInstanceID];
          }
          
          // Explicitly start tracking
          [Airbridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>

    #### iOS SDK (Deprecated)

    <CodeGroup>
      ```swift Swift lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      import FirebaseAnalytics

      // AppDelegate.swift
      func application(
          _ application: UIApplication,
          didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {

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

          return true
      }
      ```

      ```objective-c Objective-C lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
      @import FirebaseAnalytics;

      // AppDelegate.m
      - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
      {
          AirBridge.autoStartTrackingEnabled = NO;
          [AirBridge getInstance:@"YOUR_APP_SDK_TOKEN"
                         appName:@"YOUR_APP_NAME"
               withLaunchOptions:launchOptions];

          NSString *appInstanceID = [FIRAnalytics appInstanceID];
          if (appInstanceID) {
              [AirBridge.state setDeviceAliasWithKey: @"ga4_app_instance_id"
                                               value: appInstanceID];
          }
          
          // Explicitly start tracking
          [AirBridge startTracking];

          return YES;
      }
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="SDK integration (React Native)">
    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    import analytics from '@react-native-firebase/analytics';
    ```

    #### React Native SDK

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/react-native-sdk-v4#configure-sdk-settings).

    ```javascript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    const appInstanceId = await analytics().getAppInstanceId();
    Airbridge.setDeviceAlias('ga4_app_instance_id', appInstanceId);
    Airbridge.startTracking();
    ```

    #### React Native SDK (Deprecated)

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/deprecated-react-native-sdk-v2#airbridge-json).

    ```javascript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    const appInstanceId = await analytics().getAppInstanceId();
    Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);
    Airbirdge.state.startTracking();
    ```
  </Accordion>

  <Accordion title="SDK integration (Flutter)">
    ```dart lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_analytics/firebase_analytics.dart';
    ```

    #### Flutter SDK

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/flutter-sdk-v4#configure-sdk-settings).

    ```dart lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    final appInstanceId = await FirebaseAnalytics.instance.appInstanceId;

    if (appInstanceId != null) {
        Airbridge.setDeviceAlias("ga4_app_instance_id", appInstanceId);
    }

    Airbridge.startTracking();
    ```

    #### Flutter SDK (Deprecated)

    Set `autoStartTrackingEnabled` to `false` in the [airbridge.json](/en/developers/deprecated-flutter-sdk-v3#airbridge-json).

    ```dart lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    final appInstanceId = await FirebaseAnalytics.instance.appInstanceId;

    if (appInstanceId != null) {
        Airbridge.state.setDeviceAlias("ga4_app_instance_id", appInstanceId);  
    }

    Airbridge.state.startTracking();
    ```
  </Accordion>

  <Accordion title="SDK integration (Unity)">
    #### Unity SDK

    Set `Auto Start Tracking Enabled` to `false` in the [project settings](/en/developers/unity-sdk-v4#configure-sdk-settings).

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    private async void SetupAirbridgeIntegration()
    {
    #if UNITY_ANDROID || UNITY_IOS
        string appInstanceId = await Firebase.Analytics.FirebaseAnalytics.GetAnalyticsInstanceIdAsync();
        Airbridge.SetDeviceAlias("ga4_app_instance_id", appInstanceId);
    #endif
        Airbridge.StartTracking();
    }
    ```

    #### Unity SDK (Deprecated)

    Set `Auto Start Tracking Enabled` to `false` in the [project settings](/en/developers/deprecated-unity-sdk-v1#set-up-project).

    ```c# lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    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();
    }
    ```
  </Accordion>
</AccordionGroup>

### Airbridge dashboard setup

The Airbridge dashboard setup must be completed to implement the integration. For detailed instructions, refer to the user guide below.

* [GA4 Integration User Guide](/en/guides/google-analytics-4)

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/developers/google-analytics-4" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/developers/google-analytics-4" />