Integrando o Google Tag Manager com o Google Analytics

:bookmark: Este guia ajudará você a configurar o Google Tag Manager e a usá-lo com o Google Analytics em seu site Discourse. Além disso, ele aborda a configuração de variáveis, acionadores (triggers) e tags no Google Tag Manager para rastrear visualizações de página.

:information_source: Este guia cobre a configuração do Google Tag Manager. Se você deseja apenas ativar o Google Analytics para o seu site, defina a G-Tag na configuração do site ga universal tracking code. Nossas configurações ainda podem se referir a todas as análises como universal, mas isso é um artefato de nomenclatura de campo legado. As instruções a seguir usam e funcionam para as Tags do Google.

:person_raising_hand: Nível de usuário necessário: Administrador

A integração do Google Tag Manager (GTM) com o Google Analytics (GA) permite que você gerencie e rastreie eventos em seu site Discourse de forma eficaz. Este guia cobre todo o processo de configuração, desde a criação de uma conta do GA até a configuração do GTM com as tags e acionadores necessários.

Sumário

  1. Crie uma conta e propriedade do Google Analytics.
  2. Configure o Google Tag Manager.
  3. Configure variáveis, acionadores e tags do GTM.
  4. Integre o GTM com seu site Discourse.

Crie uma conta do Google Analytics

  1. Visite o Google Analytics e faça login com sua conta Google.

  2. Se você ainda não tem uma conta, siga as etapas guiadas para criar uma.

  3. Crie uma propriedade clicando em “Administrador” e depois em “Criar propriedade”.

  4. Preencha os detalhes necessários na tela “Criação de propriedade”.

  5. Insira os detalhes do seu negócio na próxima tela.

  6. Selecione seus objetivos de negócios apropriadamente.

:information_source: Info: Selecionar as quatro seções corresponderá mais de perto aos relatórios que o Analytics forneceu tipicamente:

  1. Escolha “Web” como plataforma para coleta de dados.

  2. Configure um fluxo de dados inserindo o URL do seu site e um nome para o fluxo.

:information_source: Após criar seu fluxo da web com sucesso, anote sua ID de medição. Você precisará dela para a configuração do GTM.

Configure o Google Tag Manager

  1. Visite o Google Tag Manager e crie uma conta.
  2. Configure um contêiner seguindo as etapas guiadas e escolha “Web” como plataforma.

Configure o GTM

Variáveis

  1. Vá para a aba “Variáveis” no GTM e clique em “Nova” na seção Variáveis Definidas pelo Usuário.
  2. Crie duas Variáveis da Camada de Dados (Data Layer Variables):
  • Título: DL-page-title
    Tipo: Variável da Camada de Dados
    Nome da Variável da Camada de Dados: page.title
    Versão da Camada de Dados: 2

  • Título: DL-page-url
    Tipo: Variável da Camada de Dados
    Nome da Variável da Camada de Dados: page.url
    Versão da Camada de Dados: 2

Como exemplo, escolha o tipo de variável:

Em seguida, configure as variáveis, como neste exemplo:

Acionadores (Triggers)

  1. Vá para a aba “Acionadores” e clique em “Novo”.

  2. Escolha “Evento Personalizado” como tipo.

  3. Nomeie o acionador como virtualPageView e Salve-o.

    O resultado final deve ser assim:

Tags

  1. Vá para a aba “Tags” e crie uma nova tag.

  2. Escolha Google Analytics: Google Tag como tipo de tag.

  3. Configure a tag com os seguintes detalhes:

  • ID de medição: Insira sua ID de medição do GA.
  • Campos Obrigatórios a Definir:
    • title: {{DL-page-title}}
    • page: {{DL-page-url}}
    • send_page_view: true
    • page_path: {{Page Path}}

Ao terminar, deve ficar assim (observe que você pode adicionar um parâmetro userID além dos parâmetros acima, mas precisará adicionar uma variável adicional como DL-page-url):

  1. Escolha o acionador virtualPageView para esta tag.
  2. Nomeie sua tag e Salve-a.

Publique seu workspace do GTM

Publique seu contêiner no GTM clicando no botão azul “Enviar” no canto superior direito da página.

:warning: Importante: Se você encontrar erros 404 de googletagmanager.com, certifique-se de que as alterações do seu contêiner GTM foram publicadas.

Integre o GTM com o Discourse

  1. Vá para as configurações de Administrador do seu Discourse e pesquise por gtm container id.
  2. Insira sua ID de Contêiner do GTM (formato: GTM-XXXXXX) no campo correspondente.

:warning: Nota: Remova qualquer código de rastreamento de Analytics existente nas configurações ga universal tracking code e ga tracking code no Discourse.

Recarregue seu site e verifique a visualização de Conteúdo em Tempo Real no GA para confirmar que os dados estão fluindo através do GTM.

Usos Adicionais

Com o GTM, você pode adicionar mais tags para rastrear eventos adicionais, como:

Links Relacionados

47 curtidas

Conforme observado, a tag de configuração do GA4 foi removida e agora você escolherá a Tag do Google. As etapas de configuração permanecem as mesmas, mas atualizei a documentação.

Para quem configurou anteriormente a tag do GA4, ela deve ter sido atualizada automaticamente e não requer nenhuma alteração da sua parte.

Vale a pena mencionar que esta não é uma configuração ideal em termos das melhores práticas atuais do GA4/GTM e que a etapa nº 2 na seção “Triggers” parece estar incorreta.

Em vez de um gatilho de “Page View”, este deveria ser um gatilho de “Custom Event” com o nome virtualPageView.

cookieDomain = auto parece ser um resquício do Universal Analytics e não é necessário. O GA4 lida automaticamente com a navegação entre subdomínios.

Outra melhor prática é ter a tag do Google disparada na “Initialization”, com send_page_view definido como false e, em vez disso, ter uma tag de evento GA4 separada para page_view.

Quando implementamos, também adicionamos um “override” para page_location com a URL completa do site + o caminho da página virtual. Isso preencherá corretamente os relatórios padrão do GA4.

1 curtida

Olá Stefan,

Obrigado por estas notas.

Atualizei a etapa nº 2 da seção Gatilhos, pois já tinha capturas de tela correspondentes, e atualizaremos o restante o mais rápido possível.

2 curtidas

Descrição:

Estou enfrentando um problema com o Google Tag Manager (GTM) no meu fórum Discourse. Deixe-me explicar minha configuração e o problema em detalhes:

  1. Configuração do GTM:

    • Configurei um contêiner do Google Tag Manager (ID: GTM-…MZV).
    • Para fins de teste, adicionei uma tag do Google Analytics 4 no GTM, configurada para disparar em todas as páginas durante a inicialização.
    • Não adicionei nenhum gatilho complexo, camada de usuário ou camada de dados. É apenas uma configuração básica para verificar se o GTM está funcionando.
  2. Integração do GTM com o Discourse:

    • No meu fórum Discourse, configurei o GTM inserindo o ID do contêiner (GTM-W…MZV) nas Configurações de Administrador.
    • Ao inspecionar meu site, posso ver que:
  3. O Problema:

    • Após publicar meu contêiner do GTM, fui para o Modo de Visualização no Google Tag Manager e inseri o URL do meu site (https://forum.hobiguru.com).
    • No entanto, o Depurador de Visualização do GTM informa que nenhuma tag GTM foi encontrada no meu site.
    • Apesar do gtm.js estar carregando e não haver erros visíveis, o depurador não está reconhecendo a configuração do GTM.

Capturas de Tela:

  • Captura de Tela 1: Configuração do contêiner GTM no Google Tag Manager (mostrando a tag GA4 e os gatilhos).
  • Captura de Tela 2: Configurações de Administrador do Discourse mostrando o ID do contêiner GTM (GTM-W…MZV) configurado.
  • Captura de Tela 3: Ferramentas de Desenvolvedor do Navegador mostrando que a biblioteca gtm.js está sendo carregada com sucesso no meu site.
  • Captura de Tela 4: Modo de Visualização do GTM mostrando a mensagem de erro: Nenhuma tag GTM encontrada no seu site.



O que Tentei Até Agora:

  • Confirmei que o gtm.js está carregando na aba Rede.
  • Verifiquei o console do navegador em busca de quaisquer erros de Política de Segurança de Conteúdo (CSP) ou outros erros de JavaScript.
  • Limpei o cache do meu site e do navegador para garantir que não haja problemas de cache.
  • Republiquei o contêiner do GTM para garantir que ele esteja atualizado.

Solicitação:

Alguém pode me ajudar a entender por que o Modo de Visualização do GTM não está detectando minha configuração do GTM, mesmo que o script gtm.js esteja carregando corretamente? Há algo que estou perdendo na configuração ou no processo de integração?