Integração com o Google Analytics

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.

O recurso de ID do Usuário 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, siga o guia do Google: https://support.google.com/analytics/answer/3123666

Nota

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

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

Nota

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.

Integrar o SDK Web do Pushwoosh

Para integrar o SDK do Pushwoosh em seu Google Tag Manager, siga o guia do SDK Web Push.

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.

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>

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

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

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

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

Nota

Por favor, note que o GA leva cerca de um dia para processar os dados.

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.

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.

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