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

# Firebase용 Google Analytics

> Firebase용 Google Analytics가 올바르게 구현된 경우 OneSignal은 분석 대시보드에 알림 이벤트를 자동으로 전송합니다. iOS 및 Android에서 작동합니다.

[Firebase용 Google Analytics](https://firebase.google.com/products/analytics)는 Google Firebase에서 무료로 제공하는 이벤트 추적 도구입니다. 앱 내에서 이벤트를 쉽게 추적하고 나중에 다양한 필터를 사용하여 분석할 수 있습니다.

<Warning>
  이 통합은 시작 URL에 대한 UTM 매개변수를 지원하지 않습니다.

  웹에서는 GA 코드가 브라우저의 URL을 기반으로 값을 캡처합니다.

  모바일에서는 이러한 값을 캡처하여 GA에 전달해야 합니다. 알림 페이로드를 가져오는 데 알림 열림 이벤트 핸들러를 사용할 수 있습니다.
</Warning>

## 이벤트

OneSignal SDK는 알림 열림 및 수신 이벤트와 관련된 이벤트를 추적합니다. 다음 이벤트가 전송됩니다:

| 이벤트 이름                           | 세부 정보                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------- |
| `os_notification_opened`         | OneSignal 알림이 열렸습니다                                                          |
| `os_notification_received`       | OneSignal 알림이 수신되었습니다. (**Android 전용**)                                      |
| `os_notification_influence_open` | OneSignal 알림이 수신된 후 2분 이내에 애플리케이션이 열렸습니다. ([iOS는 추가 설정 필요](./ios-sdk-setup)) |

OneSignal SDK는 이벤트가 귀속된 특정 알림에 대한 자세한 정보가 포함된 매개변수도 전송합니다:

| 매개변수 이름           | 매개변수 값                                                                                                                      | 세부 정보                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| `source`          | "OneSignal"                                                                                                                 | 이 이벤트의 소스를 OneSignal SDK에 귀속시킵니다                    |
| `medium`          | "notification"                                                                                                              | 이벤트의 매체가 알림임을 공식적으로 나타냅니다                           |
| `notification_id` | 특정 OneSignal 알림의 `notification_id`                                                                                          | 대시보드의 특정 "전송된" 알림에 알림 ID를 귀속시킬 수 있습니다               |
| `campaign`        | 템플릿을 사용하는 경우:`[template_name]-[template_id]` 그렇지 않은 경우: `headings` [API 속성](/reference/push-notification) 또는 알림 제목의 처음 10자. | 캠페인은 동일한 템플릿이나 제목을 사용하는 알림과 같이 유사한 알림을 그룹화하는 방법입니다. |

***

## Firebase용 Google Analytics와 OneSignal 이벤트 통합 설정

### Firebase 설정

[Firebase 통합 문서](https://firebase.google.com/docs/android/setup)를 따르고 Firebase가 애플리케이션 내에서 올바르게 작동하는지 확인합니다.

### OneSignal에서 Firebase 활성화

**데이터 > 통합**으로 이동하여 \*\*"Firebase"\*\*를 활성화합니다.

이렇게 하면 Firebase로 이벤트 데이터 전송이 시작됩니다. iOS에서 영향을 받은 열림을 추적하려면 Firebase의 제한으로 인해 [추가 설정](./ios-sdk-setup)을 수행해야 합니다.

<Frame caption="OneSignal에서 활성화된 Firebase">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/Integrations.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=61a02b7a3829ff83ed2f1013c186b3e4" data-path="images/integrations/Integrations.png" />
</Frame>

### OneSignal 이벤트 확인

<Steps>
  <Step title="앱 로그 확인">
    Firebase가 OneSignal 알림과 관련된 이벤트를 전송하려고 시도하는지 확인합니다

    애플리케이션의 LogCat 로그를 확인하고 OneSignal에 해당하는 이벤트가 전송되고 있음을 나타내는 Firebase용 Google Analytics 항목을 찾습니다. `os_notification_opened`, `os_notification_received` 또는 `os_notification_influence_open`을 찾으세요

    <Frame caption="LogCat의 Firebase 이벤트">
      <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0dc5c63-firebase_analytics_3.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=0d20d440318aed8908313e89084d3bb9" width="1560" height="42" data-path="images/docs/0dc5c63-firebase_analytics_3.png" />
    </Frame>
  </Step>

  <Step title="Firebase 콘솔로 이동">
    프로젝트의 [Firebase 콘솔](https://console.firebase.google.com/)로 이동합니다

    <Frame caption="Firebase 콘솔">
      <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/646c537-firebase_analytics_1.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=2637f7f9b40c23e5d69f0ab0510a127e" width="2878" height="1078" data-path="images/docs/646c537-firebase_analytics_1.png" />
    </Frame>
  </Step>

  <Step title="DebugView 설정 가이드 따르기">
    [DebugView 설정 가이드](https://firebase.google.com/docs/analytics/debugview)를 따릅니다

    DebugView를 사용하면 `debug` 모드에 있을 때 ADB가 프로젝트에 Firebase 이벤트를 전송할 수 있습니다. iOS에 대한 훌륭한 비디오는 다음과 같습니다: [https://youtu.be/kpkW78OSbiw?t=289](https://youtu.be/kpkW78OSbiw?t=289)

    디버그 로그 예제

    ```text Xcode logs example theme={null}
      2021-09-22 14:58:20.731918-0700 OneSignalDemo[33301:1350721] 7.0.0 - [Firebase/Analytics][I-ACS023073] Debug mode is enabled. Marking event as debug and real-time. Event name, parameters: os_notification_opened, {
          campaign = Firebase t;
          ga_debug (_dbg) = 1;
          ga_event_origin (_o) = app;
          ga_realtime (_r) = 1;
          medium = notification;
          notification_id = 2ecdd9bf-b2c0-443e-b5b2-7983d453c746;
          source = OneSignal;
      }
      2021-09-22 14:58:20.749723-0700 OneSignalDemo[33301:1350721] 7.0.0 - [Firebase/Analytics][I-ACS023072] Event logged. Event name, event params: os_notification_opened, {
          campaign = Firebase t;
          ga_debug (_dbg) = 1;
          ga_event_origin (_o) = app;
          ga_realtime (_r) = 1;
          medium = notification;
          notification_id = 2ecdd9bf-b2c0-443e-b5b2-7983d453c746;
          source = OneSignal;
      }
    ```
  </Step>

  <Step title="DebugView 확인">
    OneSignal 이벤트가 전파되면 DebugView에 실시간으로 나타납니다

    <Frame caption="DebugView">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/39a888e-Screen_Shot_2021-09-22_at_3.16.55_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=3bebf24697b77a5cc2acb5b0a06aec87" width="3376" height="1756" data-path="images/docs/39a888e-Screen_Shot_2021-09-22_at_3.16.55_PM.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  **Firebase용 Google Analytics를 통해 OneSignal 알림 이벤트를 추적하도록 애플리케이션이 확인되었습니다!**
</Check>

***

## FAQ

### 클릭 및 열림 이벤트가 Firebase에 표시되지 않는 이유는 무엇인가요?

Firebase 라이브러리가 제때 초기화되지 않아 Firebase 라이브러리가 이벤트를 삭제하는 경우 Firebase 클릭 이벤트 `os_notification_opened` 및 수신 이벤트 `os_notification_received`가 작동하지 않을 수 있습니다. [이 github 이슈](https://github.com/OneSignal/OneSignal-Android-SDK/issues/949)에 대한 자세한 내용을 참조하세요.

<Note>
  [Firebase 설정 튜토리얼](./google-analytics-for-firebase)에 따라 Firebase 데이터베이스를 연결하고 OneSignal과 함께 Firebase Cloud Functions를 사용하세요.
</Note>

***