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

> O OneSignal enviará automaticamente eventos de notificação para seu painel de análises se o Google Analytics para Firebase estiver implementado corretamente. Funciona com iOS e Android.

[Google Analytics para Firebase](https://firebase.google.com/products/analytics) é uma ferramenta de rastreamento de eventos fornecida gratuitamente pelo Google Firebase. Ela permite que você rastreie facilmente eventos dentro do seu aplicativo e os analise posteriormente usando vários filtros.

<Warning>
  Esta integração não suporta parâmetros UTM para a URL de abertura.

  Na Web, o código GA capturará os valores com base na URL no navegador.

  No Mobile, você precisará capturar esses valores e passá-los para o GA. Nosso Manipulador de Evento de Notificação Aberta pode ser usado para obter o payload da notificação.
</Warning>

## Eventos

O SDK OneSignal rastreia eventos relacionados a eventos de abertura e recebimento de notificação. Os seguintes eventos são enviados:

| Nome do Evento                   | Detalhes                                                                                                                                         |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `os_notification_opened`         | Uma notificação OneSignal foi aberta                                                                                                             |
| `os_notification_received`       | Uma notificação OneSignal foi recebida. (**Somente Android**)                                                                                    |
| `os_notification_influence_open` | Um aplicativo foi aberto dentro de 2 minutos após uma notificação OneSignal ser recebida. ([iOS requer configuração adicional](./ios-sdk-setup)) |

O SDK OneSignal também envia parâmetros que contêm mais informações sobre a notificação específica à qual o evento é atribuído:

| Nome do Parâmetro | Valor do Parâmetro                                                                                                                                                         | Detalhes                                                                                                                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `source`          | "OneSignal"                                                                                                                                                                | Para atribuir a origem deste evento ao SDK OneSignal                                                                    |
| `medium`          | "notification"                                                                                                                                                             | Uma indicação formal de que o meio para o evento é uma notificação                                                      |
| `notification_id` | o `notification_id` de uma notificação OneSignal específica                                                                                                                | Você pode atribuir um ID de notificação a uma notificação "enviada" específica no painel                                |
| `campaign`        | Se usar um template:`[template_name]-[template_id]` Se não: Primeiras 10 letras da [propriedade da API](/reference/push-notification) `headings` ou Título da notificação. | Campanhas são uma forma de agrupar notificações que são similares, como notificações usando o mesmo template ou título. |

***

## Configurar integração de eventos OneSignal com Google Analytics para Firebase

### Configurar Firebase

Siga a [documentação de integração do Firebase](https://firebase.google.com/docs/android/setup) e verifique se o Firebase está funcionando corretamente dentro do seu aplicativo.

### Habilitar Firebase no OneSignal

Navegue até **Dados > Integrações** e habilite **"Firebase"**.

Isso começará a enviar dados de eventos para o Firebase. Se você deseja rastrear aberturas influenciadas no iOS, você precisará realizar alguma [configuração adicional](./ios-sdk-setup) devido a limitações no Firebase.

<Frame caption="Firebase habilitado no 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>

### Verificar eventos OneSignal

<Steps>
  <Step title="Verificar os logs do seu aplicativo">
    Verifique se o Firebase está tentando enviar eventos relacionados às notificações OneSignal

    Verifique nos logs LogCat do seu aplicativo e procure por entradas do Google Analytics para Firebase que indiquem que eventos correspondentes ao OneSignal estão sendo enviados. Procure por `os_notification_opened`,`os_notification_received`, ou `os_notification_influence_open`

    <Frame caption="Eventos Firebase no 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="Ir para o console do Firebase">
    Vá para o [Console do Firebase](https://console.firebase.google.com/) do seu projeto

    <Frame caption="Console do 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="Seguir o Guia de Configuração do DebugView">
    Siga o [Guia de Configuração do DebugView](https://firebase.google.com/docs/analytics/debugview)

    O DebugView permite que o ADB envie eventos do Firebase para seu projeto quando está no modo `debug`. Aqui está um ótimo vídeo sobre isso para iOS: [https://youtu.be/kpkW78OSbiw?t=289](https://youtu.be/kpkW78OSbiw?t=289)

    Exemplo de Logs de Depuração

    ```text Exemplo de logs do Xcode 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="Verificar o DebugView">
    À medida que os eventos OneSignal se propagam, eles aparecerão em tempo real no 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>
  **Seu aplicativo foi verificado para rastrear eventos de notificação OneSignal através do Google Analytics para Firebase!**
</Check>

***

## FAQ

### Por que os eventos de clique e abertura não estão aparecendo no Firebase?

O evento de clique do Firebase `os_notification_opened` e evento recebido `os_notification_received` podem não funcionar se a biblioteca do Firebase não tiver sido inicializada a tempo, então a biblioteca do Firebase descarta o evento. Mais detalhes nesta [issue do github](https://github.com/OneSignal/OneSignal-Android-SDK/issues/949).

<Note>
  Vincule seu Firebase Database e use Firebase Cloud Functions com OneSignal seguindo nosso [Tutorial de Configuração do Firebase](./google-analytics-for-firebase).
</Note>

***