> ## 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.

# 구글 애널리틱스 4(GA4)

에어브릿지는 구글 애널리틱스 4(Google Analytics 4, GA4) 연동을 지원합니다. 에어브릿지 사용자는 GA4에서 에어브릿지의 광고 성과 데이터로 더 정교하게 프로덕트를 분석할 수 있습니다.

<Info>
  **알립니다**

  GA4에 등록된 앱만 에어브릿지와 연동할 수 있습니다.
</Info>

## 연동하기

Firebase Analytics SDK의 App Instance ID를 에어브릿지 SDK의 디바이스 알리아스(Device Alias)로 지정하는 방식으로 에어브릿지 SDK로 수집되는 데이터를 구글 애널리틱스 4(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

### 사전 준비사항

<Danger>
  **주의하세요**

  연동을 마치기 위해서는 에어브릿지 대시보드 설정이 필요합니다. SDK 설정 이후에 반드시 필요한 모든 설정을 진행해 주세요.
</Danger>

에어브릿지 SDK에 아래 코드를 삽입합니다. 에어브릿지 SDK 작업을 하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 GA4가 정상적으로 연동되지 않습니다.

<AccordionGroup>
  <Accordion title="SDK 연동하기 (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 연동하기 (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 연동하기 (React Native)">
    ```typescript lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
    import analytics from '@react-native-firebase/analytics';
    ```

    #### React Native SDK

    [`airbridge.json`](/ko/developers/react-native-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

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

    [`airbridge.json`](/ko/developers/deprecated-react-native-sdk-v2#airbridge-json)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```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 연동하기 (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

    [`airbridge.json`](/ko/developers/flutter-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

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

    [`airbridge.json`](/ko/developers/deprecated-flutter-sdk-v3#airbridge-json)의 `autoStartTrackingEnabled` 옵션을 `false`로 설정해야 합니다.

    ```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 연동하기 (Unity)">
    #### Unity SDK

    [프로젝트 설정](/ko/developers/unity-sdk-v4#sdk-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0)의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.

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

    [프로젝트 설정](/ko/developers/deprecated-unity-sdk-v1#프로젝트-설정)의 Auto Start Tracking Enabled 옵션을 false로 설정해야 합니다.

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

### 에어브릿지에서 GA4 연동하기

SDK 작업을 마친 후에 에어브릿지 대시보드에서 필요한 작업을 마쳐야 모든 연동 과정이 마무리됩니다. 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

* [GA4 연동하기 (유저 가이드)](/ko/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" />