# Integração com o Google Analytics

<Aside type="caution" icon="setting" title="Assistência de desenvolvedor necessária">
 Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.
</Aside>

O recurso de [ID do Usuário](https://support.google.com/analytics/answer/3123662?authuser=1) do Google Analytics permite que você colete e aplique dados abrangentes do usuário, conectando várias fontes de dados aos mesmos usuários.
Conecte o Pushwoosh com o Google Analytics e use os dados do GA para segmentação de público e direcionamento de suas campanhas de notificações push. Vamos ver como funciona.

## Ativar o ID do Usuário

Para ativar o recurso de ID do Usuário em sua [conta do Google Analytics](https://analytics.google.com/analytics/web/provision/#/provision), siga o guia do Google: [https://support.google.com/analytics/answer/3123666](https://support.google.com/analytics/answer/3123666)

<Aside type="note">
Não se esqueça de criar uma visualização de relatórios de ID do Usuário (conforme descrito no _Passo 3_ do guia do GA sobre a ativação do ID do Usuário).
</Aside>

## Configurar o ID do Usuário em seu código de rastreamento

<Aside type="note">
 Somos compatíveis com o Google Tag Manager

Incentivamos o uso do Google Tag Manager (GTM) para integrar o SDK do Pushwoosh. O código a seguir é baseado no GTM, mas é fácil modificá-lo para ser executado como um Javascript simples em uma página.
</Aside>

## Integrar o SDK Web do Pushwoosh

Para integrar o SDK do Pushwoosh em seu Google Tag Manager, siga o [guia do SDK Web Push](/pt/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30#installing-from-google-tag-manager).

## Criar tag de ID do Usuário no GTM

Crie uma **Tag HTML Personalizada** acionada no gatilho **Todas as Páginas**.\
Use o código a seguir para configurar o ID do Usuário que corresponde aos dados do usuário entre o Pushwoosh e o Google Analytics.

No exemplo abaixo, usamos o Hardware ID (HWID) do Pushwoosh para configurar o ID do Usuário. Você pode usar um identificador diferente, mas esteja ciente de não colocar endereços de e-mail ou qualquer outra informação de identificação pessoal (PII) no ID do Usuário, pois isso não está em conformidade com a [Política de Privacidade do Google Analytics](https://policies.google.com/privacy).

```javascript title="JavaScript"
<script>
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var registrationId = localStorage.deviceRegistrationId;
  var gaRegistered = registrationStatus === 'registered' ? registrationId : false;

  if (!gaRegistered) {
    var Pushwoosh = Pushwoosh || [];
    Pushwoosh.push(['onPermissionGranted', function(api) {
      api.getParams()
        .then(function(params) {
          var hwid = params.hwid;
          ga('set', 'userId', hwid);
          ga('send', 'pageview');
          localStorage.setItem('deviceRegistrationId', hwid);
          api.registerUser(hwid);
        })
    }])
};
</script>
```

<img src="/integrations-google-analytics-integration-1.webp" alt="Tag HTML personalizada no Google Tag Manager para configuração do ID do Usuário"/>

## Adicionar ID do Usuário à tag de Visualização de Página

Modifique sua **tag de Visualização de Página** para incluir o ID do Usuário, se for conhecido para o usuário:

```javascript title="JavaScript"
<script>
  var hwid = localStorage.deviceRegistrationId;
  var registrationStatus = localStorage.deviceRegistrationStatus;
  var isNeedToTrackUser = hwid && registrationStatus === "registered";

  if (isNeedToTrackUser) {
    ga('set', 'userId', hwid);
  };
  ga('send', 'pageview');
</script>
```

<img src="/integrations-google-analytics-integration-2.webp" alt="Configuração da tag de Visualização de Página com ID do Usuário"/>

## Testar com o relatório de cobertura de ID do Usuário

Para testar a integração, use o "Relatório de cobertura de ID do Usuário":\
[https://support.google.com/analytics/answer/3123670](https://support.google.com/analytics/answer/3123670)

<Aside type="note">
Por favor, note que o GA leva cerca de um dia para processar os dados.
</Aside>

## User Explorer

Selecione sua visualização de relatórios de ID do Usuário no Google Analytics. Adicione quaisquer segmentos lá para analisar e segmentar seu público.

<img src="/integrations-google-analytics-integration-3.webp" alt="Botão Novo Segmento para dividir o público em segmentos"/>

Você pode ver seus IDs de Usuário exibidos na coluna "ID do Usuário". Use o botão **Exportar** e selecione a opção CSV para baixar a lista de IDs de Usuário.

<img src="/integrations-google-analytics-integration-4.webp" alt="Coluna de ID do Usuário exibindo identificadores de usuário"/>

## Enviar notificações push para IDs de Usuário do GA

Para enviar um push para usuários do seu público do GA, use o [Push Único](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/) e, na etapa **Público**, escolha **Importar segmento**. Faça o upload do arquivo CSV que você exportou do Google Analytics e mapeie a coluna que contém os IDs de Usuário para o campo ID do Usuário. [Saiba mais](/pt/product/audience-data-and-segmentation/segmentation/create-segments/by-import/#how-to-import-a-segment)