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

# Google Analytics for Firebase

> Google Analytics for Firebaseが正しく実装されている場合、OneSignalは通知イベントを自動的に分析ダッシュボードに送信します。iOSとAndroidで動作します。

[Google Analytics for Firebase](https://firebase.google.com/products/analytics)は、Google Firebaseが無料で提供するイベント追跡ツールです。アプリ内のイベントを簡単に追跡し、後でさまざまなフィルターを使用して分析できます。

<Warning>
  このインテグレーションは、起動URLへのUTMパラメータをサポートしていません。

  Webでは、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文字。 | キャンペーンは、同じテンプレートやタイトルを使用している通知など、類似した通知をグループ化する方法です。 |

***

## Google Analytics for Firebaseでの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に対応するイベントが送信されていることを示すGoogle Analytics for Firebaseエントリを探します。`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を使用すると、ADBが`debug`モードのときに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>
  **アプリケーションがGoogle Analytics for Firebaseを通じてOneSignal通知イベントを追跡することが確認されました！**
</Check>

***

## FAQ

### クリックイベントと開封イベントがFirebaseに表示されないのはなぜですか？

Firebaseライブラリが時間内に初期化されていない場合、Firebaseクリックイベント`os_notification_opened`と受信イベント`os_notification_received`が機能しない可能性があるため、Firebaseライブラリはイベントをドロップします。詳細については、[このgithubの問題](https://github.com/OneSignal/OneSignal-Android-SDK/issues/949)を参照してください。

<Note>
  [Firebaseセットアップチュートリアル](./google-analytics-for-firebase)に従って、Firebase DatabaseをリンクしてFirebase Cloud FunctionsをOneSignalで使用してください。
</Note>

***