> ## 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 pour Firebase

> OneSignal enverra automatiquement des événements de notification à votre tableau de bord d'analyse si Google Analytics pour Firebase est correctement implémenté. Fonctionne avec iOS et Android.

[Google Analytics pour Firebase](https://firebase.google.com/products/analytics) est un outil de suivi d'événements fourni gratuitement par Google Firebase. Il vous permet de suivre facilement les événements dans votre application et de les analyser ultérieurement à l'aide de divers filtres.

<Warning>
  Cette intégration ne prend pas en charge les paramètres UTM vers l'URL de lancement.

  Sur le Web, le code GA capturera les valeurs en fonction de l'URL dans le navigateur.

  Sur mobile, vous devrez capturer ces valeurs et les transmettre à GA. Notre gestionnaire d'événements de notification ouverte peut être utilisé pour obtenir la charge utile de la notification.
</Warning>

## Événements

Le SDK OneSignal suit les événements liés aux événements d'ouverture et de réception de notifications. Les événements suivants sont envoyés :

| Nom de l'événement               | Détails                                                                                                                                                                 |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `os_notification_opened`         | Une notification OneSignal a été ouverte                                                                                                                                |
| `os_notification_received`       | Une notification OneSignal a été reçue. (**Android uniquement**)                                                                                                        |
| `os_notification_influence_open` | Une application a été ouverte dans les 2 minutes suivant la réception d'une notification OneSignal. ([iOS nécessite une configuration supplémentaire](./ios-sdk-setup)) |

Le SDK OneSignal envoie également des paramètres qui contiennent plus d'informations sur la notification particulière à laquelle l'événement est attribué :

| Nom du paramètre  | Valeur du paramètre                                                                                                                                                                         | Détails                                                                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `source`          | "OneSignal"                                                                                                                                                                                 | Pour attribuer la source de cet événement au SDK OneSignal                                                                             |
| `medium`          | "notification"                                                                                                                                                                              | Une indication formelle que le support de l'événement est une notification                                                             |
| `notification_id` | le `notification_id` d'une notification OneSignal particulière                                                                                                                              | Vous pouvez attribuer un ID de notification à une notification "envoyée" particulière sur le tableau de bord                           |
| `campaign`        | Si vous utilisez un modèle :`[template_name]-[template_id]` Sinon : Les 10 premières lettres de la [propriété API](/reference/push-notification) `headings` ou du titre de la notification. | Les campagnes sont un moyen de regrouper des notifications similaires, telles que des notifications utilisant le même modèle ou titre. |

***

## Configurer l'intégration des événements OneSignal avec Google Analytics pour Firebase

### Configurer Firebase

Suivez la [documentation d'intégration Firebase](https://firebase.google.com/docs/android/setup) et vérifiez que Firebase fonctionne correctement dans votre application.

### Activer Firebase dans OneSignal

Naviguez vers **Données > Intégrations** et activez **"Firebase"**.

Cela commencera à envoyer des données d'événement à Firebase. Si vous souhaitez suivre les ouvertures influencées sur iOS, vous devrez effectuer une [configuration supplémentaire](./ios-sdk-setup) en raison des limitations de Firebase.

<Frame caption="Firebase activé dans OneSignal">
  <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>

### Vérifier les événements OneSignal

<Steps>
  <Step title="Vérifiez les journaux de votre application">
    Vérifiez que Firebase tente d'envoyer des événements liés aux notifications OneSignal

    Vérifiez dans les journaux LogCat de votre application et recherchez les entrées Google Analytics pour Firebase qui indiquent que des événements correspondant à OneSignal sont envoyés. Recherchez `os_notification_opened`, `os_notification_received` ou `os_notification_influence_open`

    <Frame caption="Événements Firebase dans LogCat">
      <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="Accédez à la console Firebase">
    Accédez à la [Console Firebase](https://console.firebase.google.com/) pour votre projet

    <Frame caption="Console 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="Suivez le guide de configuration DebugView">
    Suivez le [guide de configuration DebugView](https://firebase.google.com/docs/analytics/debugview)

    DebugView permet à ADB d'envoyer des événements Firebase à votre projet lorsqu'il est en mode `debug`. Voici une excellente vidéo à ce sujet pour iOS : [https://youtu.be/kpkW78OSbiw?t=289](https://youtu.be/kpkW78OSbiw?t=289)

    Exemples de journaux de débogage

    ```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="Vérifiez la DebugView">
    Au fur et à mesure que les événements OneSignal se propagent, ils apparaîtront en temps réel sur la 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>
  **Votre application a été vérifiée pour suivre les événements de notification OneSignal via Google Analytics pour Firebase !**
</Check>

***

## FAQ

### Pourquoi les événements de clic et d'ouverture ne s'affichent-ils pas dans Firebase ?

L'événement de clic Firebase `os_notification_opened` et l'événement de réception `os_notification_received` peuvent ne pas fonctionner si la bibliothèque Firebase ne s'est pas initialisée à temps, de sorte que la bibliothèque Firebase abandonne l'événement. Plus de détails sur [ce problème github](https://github.com/OneSignal/OneSignal-Android-SDK/issues/949).

<Note>
  Liez votre base de données Firebase et utilisez les fonctions cloud Firebase avec OneSignal en suivant notre [tutoriel de configuration Firebase](./google-analytics-for-firebase).
</Note>

***