O Google Tag Manager é um sistema para configurar e publicar tags de medição por uma interface web. Você instala o código do contêiner no site uma vez e passa a controlar ali as tags, os acionadores e as variáveis. A tag executa uma ação, o acionador decide quando ela pode executar e a variável fornece o valor usado na decisão ou no envio.

Essa separação explica boa parte das falhas de quem está começando. Uma tag do GA4 pode estar certa e ficar parada porque o acionador espera outro evento. Pode disparar com um ID de transação vazio porque a variável não achou o dado. E uma edição que funciona em Visualizar pode não existir no site ao vivo se a versão não foi publicada. Se uma medição que funcionava parou, veja também o guia de diagnóstico de rastreamento.

Se o contêiner ainda não está instalado, comece pelo guia de conta, contêiner e instalação do GTM. Para a Google tag e a escolha do ID, veja Google tag no GTM.

Tag, acionador e variável: o contrato de cada peça

Uma tag é a configuração que executa um trecho de código ou envia dados a um produto quando um evento atende às regras definidas. Segundo a visão geral oficial do Gerenciador de tags, o contêiner reúne tags, acionadores, variáveis e configurações relacionadas. Os tipos mais usados num site são a tag do Google, o evento do GA4, a conversão do Google Ads e o Vinculador de conversões. Use HTML personalizado só quando nenhum modelo confiável cobre o caso, porque código livre aumenta a superfície de revisão e de segurança.

O acionador observa eventos, como visualização de página, clique, envio de formulário ou um evento enviado pelo dataLayer. Quando o evento ocorre, ele avalia filtros feitos de variável, operador e valor. Cada tag precisa de pelo menos um acionador, conforme a documentação sobre acionadores. A tag do Google usa Inicialização: todas as páginas, como orienta a ajuda do Google; visualização de página e eventos personalizados ficam para as tags de evento.

A variável entra dos dois lados. No acionador, limita o disparo a uma URL ou a um valor. Na tag, preenche parâmetros dinâmicos. A referência de variáveis do GTM separa as incorporadas, como a URL da página, das definidas pelo usuário, como as que leem o dataLayer.

Fluxo em que um evento passa pelo acionador, recebe um valor de variável, libera a tag e segue para confirmação no destino.
O acionador decide quando a tag executa, e a variável fornece o valor avaliado ou enviado. O GTM confirma a execução; o destino confirma o recebimento.

Combine uma regra de nomes antes da primeira tag. Um padrão como GA4 | evento | purchase ou Ads | conversão | lead aprovado diz produto, função e evento. Faça o mesmo com acionadores e variáveis; Tag 1 e Variável teste ficam incompreensíveis em poucas semanas.

Um purchase completo, do dataLayer à tag do GA4

Na referência do evento purchase, transaction_id e items são obrigatórios, currency é obrigatório quando há value, e cada item precisa de item_id ou item_name. Um push sem items gera receita sem produto nos relatórios. O formato que a documentação de e-commerce no GTM usa coloca tudo dentro do objeto ecommerce:

<script>
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null }); // limpa o objeto anterior
window.dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: 'PEDIDO_8472',
    value: 189.90,
    currency: 'BRL',
    items: [
      { item_id: 'CURSO_GA4', item_name: 'Curso GA4', price: 189.90, quantity: 1 }
    ]
  }
});
</script>

Em produção, o transaction_id vem do checkout ou do sistema financeiro, e o push acontece depois da confirmação do pedido. Um literal como o do exemplo só serve para teste.

No contêiner, monte as três peças assim:

Peça Configuração O que conferir no Preview
Acionador Evento personalizado, nome do evento purchase (com p minúsculo) Aparece no evento purchase da linha do tempo
Tag Google Analytics: evento do GA4, ID de medição do fluxo Web (G-), nome do evento purchase Aparece em tags que dispararam no evento purchase
Envio dos itens Na seção de comércio eletrônico das configurações da tag, ativar o envio de dados de e-commerce com a camada de dados como fonte Na requisição, os parâmetros de item aparecem preenchidos
Variável DLV - transaction_id Variável da camada de dados, chave ecommerce.transaction_id PEDIDO_8472
Variável DLV - value Variável da camada de dados, chave ecommerce.value 189.9

Com o envio de e-commerce ativado, a tag lê o objeto ecommerce inteiro, e você não precisa mapear cada parâmetro à mão. As duas variáveis servem para outra coisa: conferir no Preview que o dado chegou e criar uma exceção que impede o disparo quando transaction_id vem vazio.

O ID G- é o ID de medição do fluxo de dados Web do GA4, e não da propriedade. Ele fica em Administrador > Fluxos de dados > fluxo Web no GA4.

Dois erros aparecem aqui com frequência. Se o site envia Purchase com P maiúsculo, o acionador purchase não casa, porque a comparação padrão (“é igual a”) diferencia maiúsculas de minúsculas. Se transaction_id chega vazio, a tag executa e envia um registro ruim. A aba Variables do Preview mostra os dois no mesmo evento.

Uma conversão deve depender do fato que comprova a ação, como o purchase enviado após a confirmação ou o lead aceito pelo sistema. Disparar conversão em qualquer page view, no clique do botão ou numa página de agradecimento que pode ser recarregada costuma inflar o relatório, porque o GTM executa a regra escrita mesmo quando ela representa mal o negócio.

Se a implementação envolve consentimento, não use o acionador como substituto de uma política de coleta. O GTM tem verificações de consentimento integradas e adicionais, e o guia sobre como validar o Consent Mode V2 mostra a ordem do padrão, da atualização e dos quatro sinais.

Testar a tag nova antes de publicar

Clique em Visualizar, informe a URL e conecte o Tag Assistant. Reproduza a ação, selecione o evento exato na linha do tempo e confira:

  1. a tag aparece em tags que dispararam no evento certo;
  2. as variáveis do evento têm os valores da tabela acima;
  3. um caso que não deveria disparar continua sem disparo.

Depois, prove transporte e recebimento pelas três etapas do diagnóstico do Tag Assistant. Lembre que o DebugView só mostra dispositivos em modo de depuração e esconde eventos com o consentimento de analytics negado. Se a tag aparece no Preview e some no site ao vivo, o mesmo artigo trata o caso.

Publicar em versões pequenas

Publicar muda o site. Revise quais tags foram adicionadas, alteradas ou removidas, rode o Preview nos caminhos críticos e confira o caso negativo. Dê à versão um nome e uma descrição que permitam reconhecer a mudança; desde 17/09/2026, segundo as notas de versão do Tag Manager, a tela de envio sugere um nome e uma descrição gerados automaticamente, que vale revisar antes de aceitar. O GTM também permite criar uma versão sem publicar, útil quando a mudança precisa de aprovação.

Mantenha as mudanças pequenas. Um pacote com consentimento, Analytics, mídia e scripts personalizados juntos torna difícil achar a edição que quebrou o comportamento. O histórico permite voltar à versão anterior, mas o rollback não recupera eventos perdidos nem apaga dados enviados por engano.

No rastreamento server-side existe outra camada: o contêiner Web envia a requisição ao contêiner Servidor, que processa e encaminha. Uma tag no servidor não conserta um evento que nunca saiu do navegador. Se esse é o próximo passo, veja quanto custa hospedar um contêiner server-side. Para montar a estrutura com validação ponta a ponta, conheça os serviços da Advanced Tracking Academy.

Para aplicar tags, acionadores e variáveis a uma solicitação real, siga o roteiro de tagueamento de site, da confirmação do formulário ao recebimento no GA4.