Integrando o Google Tag Manager com o Google Analytics

:bookmark: Este guia o ajudará a configurar o Gerenciador de Tags do Google e a usá-lo com o Google Analytics em seu site Discourse. Além disso, ele cobre a configuração de variáveis, acionadores e tags no Gerenciador de Tags do Google para rastrear visualizações de página.

:information_source: Este guia cobre a configuração do Gerenciador de Tags do Google. Se você deseja apenas ativar o Google Analytics para 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 este é um artefato de nomenclatura de campo legado. As instruções a seguir usam e funcionam para Tags do Google.

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

A integração do Gerenciador de Tags do Google (GTM) com o Google Analytics (GA) permite gerenciar e rastrear eventos em seu site Discourse de forma eficaz. Este guia cobre todo o processo de configuração, desde a criação de uma conta 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 Gerenciador de Tags do Google.
  3. Configure variáveis, acionadores e tags do GTM.
  4. Integre o GTM ao 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 da propriedade”.

  5. Insira os detalhes da sua empresa na próxima tela.

  6. Selecione seus objetivos de negócios apropriadamente.

:information_source: Info: A seleção das quatro seções corresponderá mais de perto aos relatórios que o Analytics tipicamente forneceu:

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

  2. Configure um fluxo de dados inserindo a URL do seu site e um nome de 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 Gerenciador de Tags do Google

  1. Visite o Gerenciador de Tags do Google 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 guia “Variáveis” no GTM e clique em “Novo” na seção Variáveis Definidas pelo Usuário.
  2. Crie duas Variáveis de Camada de Dados:
  • Título: DL-page-title
    Tipo: Variável de Camada de Dados
    Nome da Variável de Camada de Dados: page.title
    Versão da Camada de Dados: 2

  • Título: DL-page-url
    Tipo: Variável de Camada de Dados
    Nome da Variável de 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 guia “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 guia “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 seu 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 espaço de trabalho 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 no seu contêiner do GTM foram publicadas.

Integre o GTM com o Discourse

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

:warning: Nota: Remova qualquer código de rastreamento de Analytics existente na configuração ga universal tracking code no Discourse ao usar o GTM, para evitar rastreamento duplicado.

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?