Google Analytics 2027 · Capítulo 6 de 35 · 11 min
Organizar o Tag Manager para que a tag certa dispare uma vez
Um contêiner em que cada tag tem acionador nomeado, variável documentada e versão com dono, publicado depois da prévia e revertido em um clique.
Este capítulo faz parte do curso gratuito Google Analytics 2027.
Com uma única Google tag na página, o site registra visitas. O que ele ainda não registra é o que a Verde Vivo precisa decidir: quem pediu orçamento, quem clicou no WhatsApp, quem ligou, quem baixou o guia de cuidados. Cada acontecimento desses pede uma tag de evento, e cada tag pede uma regra que a dispare uma vez, na hora certa.
Um contêiner sem organização cobra caro de dois jeitos. No dia a dia, porque ninguém sabe qual das 140 tags dispara em qual página, e cada pergunta vira uma tarde de investigação. Na falha, porque uma publicação sem prévia numa sexta à noite derruba a coleta do fim de semana, e o relatório de segunda mostra um buraco que a equipe demora a explicar.
O contêiner é um sistema com cinco camadas, três tipos de peça e um ciclo de publicação, e cada parte tem uma regra simples. Ao fim, a Verde Vivo terá formulário, telefone, WhatsApp e download medidos com nomes que o capítulo 7 vai formalizar, e um número de leads que bate com o CRM.
A estrutura começa na conta, que pertence à empresa e não à agência. Dentro dela vive o contêiner, um por site ou por aplicativo, com um ID próprio que vai no código. Dentro do contêiner, o espaço de trabalho (workspace, a área de rascunho em que uma pessoa edita sem afetar o que está no ar) guarda as mudanças até virarem uma versão. A versão é a fotografia publicada, com nome, nota e autor. O ambiente (environment, o rótulo que separa o que roda em homologação do que roda em produção) decide para onde cada versão vai.
- Etapa 1 de 6: Espaço de trabalho
Marina edita a tag de WhatsApp sem tocar no que está no ar
- Etapa 2 de 6: Prévia
Tag Assistant conectado ao site: cada clique mostra o que disparou
- Etapa 3 de 6: Versão
Nome, nota e autor: "v41: evento whatsapp_click com parâmetro pagina"
- Etapa 4 de 6: Homologação
Publicada no ambiente de teste, conferida no DebugView da propriedade de teste
- Etapa 5 de 6: Produção
Publicada por Caio, que não foi quem editou
- Etapa 6 de 6: Reversão
Se algo quebrar, a versão anterior volta em um clique, sem deploy
As três peças do contêiner respondem a três perguntas. A tag é o que dispara: a Google tag, uma tag de evento do GA4, uma tag de conversão do Google Ads. O acionador (trigger, a condição que decide quando a tag dispara) responde "em que momento". A variável responde "com qual dado": a URL da página, o texto do botão, o valor lido do dataLayer (a fila de dados que o site deixa pronta para a tag ler).
A Google tag dentro do contêiner carrega a configuração compartilhada. Parâmetros que precisam ir em todo evento (a moeda, o identificador de usuário logado, o ambiente) entram uma vez numa variável de configurações de evento e são herdados por todas as tags de evento do GA4. Escrever a moeda em cada tag separadamente é como a Verde Vivo tinha "BRL" em nove tags e "R$" numa décima.
A tag de evento do GA4 é a peça que multiplica. Ela leva o nome do evento (generate_lead, whatsapp_click) e os parâmetros que o descrevem, cada um lido de uma variável. Uma tag por evento, com o nome oficial do capítulo 7, e nunca uma tag genérica que muda o nome do evento por uma tabela de consulta, porque ninguém consegue auditar o que ela faz seis meses depois.
Acionador confiável é o que dispara pelo acontecimento, não pela aparência. O acionador de clique funciona quando o elemento tem um atributo estável, como um data-attribute combinado com o desenvolvedor; disparar pelo texto do botão quebra na primeira troca de "Enviar" por "Pedir orçamento". O de formulário dispara no envio do HTML, aceito ou não. O de evento personalizado espera um push no dataLayer, e é o único que sabe se o servidor aceitou.
Os acionadores do GTM: quando cada um é confiável e onde ele engana
| Acionador | Dispara quando | Confiável para | Onde engana |
|---|---|---|---|
| Clique em elemento | Qualquer clique num elemento que casa com a condição | Botão com data-attribute fixo; link tel: e link do WhatsApp | Condição pelo texto ou pela classe CSS, que muda a cada redesign |
| Envio de formulário | O navegador envia o formulário | Formulário simples com página de obrigado | Formulário em React que valida e envia por JavaScript; conta a tentativa como lead |
| Evento personalizado | O site faz um push no dataLayer com o nome combinado | Tudo que depende de resposta do servidor: lead aceito, compra confirmada | Só engana quando o desenvolvedor dispara o push antes da resposta |
| Visibilidade de elemento | Um elemento entra na tela | Mensagem de sucesso que aparece sem trocar de página | Elemento que já existe oculto no HTML e conta como visto |
| Mudança de histórico | A URL muda sem recarregar a página | Troca de rota em aplicação de página única | Combinado com a medição otimizada de mudança de histórico, gera page_view em dobro |
As variáveis são o vocabulário do contêiner. A variável de URL lê o caminho, o domínio ou um parâmetro de consulta. A variável de atributo lê o data-attribute do elemento clicado. A tabela de consulta (lookup table, a variável que traduz um valor de entrada num valor de saída) resolve o caso clássico: o domínio do site devolve o ID de medição de produção e o domínio de homologação devolve o de teste. A tabela de expressão regular faz o mesmo quando a entrada tem variações.
A publicação é onde a disciplina se prova. A prévia (o modo em que o Tag Assistant se conecta ao site e mostra, clique a clique, o que disparou) precede toda publicação, sem exceção de tamanho. A aprovação é uma regra de equipe: quem publica não é quem editou, e a versão leva nome e nota. A reversão é publicar a versão anterior, o que só é possível se cada versão foi publicada como uma unidade com sentido, e não como um saco de mudanças de três semanas.
O ano de 2026 trouxe mudanças no produto que afetam essa rotina. A fusão de 20 de agosto de 2026 fez da Google tag um contêiner completo, com a seção Settings e a aba Advanced, e trouxe o tagueamento visual em beta, restrito a conversões de compra do Google Ads. Antes disso, as notas de versão registraram o Google Ads coletando eventos de site mais amplos de forma automática e o servidor juntando sinais do navegador quando há GCLID.
O que mudou no Tag Manager e na Google tag em 2026
- 4 de fevereiro de 2026Concluído
Google Ads passa a coletar eventos de site mais amplos automaticamente
- 1 de maio de 2026Concluído
GTM server-side junta sinais paralelos do navegador para propriedades vinculadas ao Ads
Quando o Google signals está ligado
- 22 de junho de 2026Concluído
Junção server-to-server com sinais do navegador quando há GCLID
- 1 de julho de 2026Concluído
Nova página Overview do contêiner
- 9 de julho de 2026Concluído
Restrição de caminhos de instalação passa a depender do tipo de ID do contêiner
- 20 de agosto de 2026Agora
Google tag e GTM se fundem
Contêiner completo, seção Settings, aba Advanced, tagueamento visual em beta; upgrade opcional por convite
Armadilha comum: medir o lead pelo acionador de clique no botão "Enviar". Cada tentativa com campo em branco, cada e-mail inválido e cada clique duplo viram um generate_lead, e o relatório mostra três vezes mais leads do que o CRM recebeu. A equipe de mídia otimiza para um evento que não representa ninguém, e a taxa de conversão de lead em contrato despenca no papel sem ter mudado na vida real.
A Verde Vivo vivia essa armadilha. O contêiner que a agência deixou tinha 140 tags, 31 delas pausadas, e o lead B2B era medido pelo clique no botão do formulário: 260 "leads" em agosto, contra 92 orçamentos que chegaram ao HubSpot. Telefone, WhatsApp e download do guia de cuidados não eram medidos, e a moeda estava escrita de dois jeitos entre as tags de compra.
Marina e Caio refizeram o contêiner em duas semanas. O formulário B2B passou a disparar generate_lead por evento personalizado, com push no dataLayer só depois da resposta do servidor que grava o orçamento. O telefone virou phone_click, pelo acionador de clique em link tel:. O WhatsApp virou whatsapp_click, pelo link do botão fixo, com o parâmetro pagina lido de uma variável de URL. O download do guia ficou com o file_download da medição otimizada, que já cobria o PDF.
Setembro fechou com 92 generate_lead, número igual ao de orçamentos no HubSpot, 61 phone_click, 340 whatsapp_click e 1.180 file_download do guia de cuidados. As 140 tags viraram 38, todas com acionador nomeado e dono. A moeda passou a vir da configuração compartilhada. A versão 41, publicada por Caio a partir da edição de Marina, foi a primeira com nome, nota e prévia registrada.
O contêiner da Verde Vivo antes e depois da reorganização
Como a agência deixou
Antes
- 140 tags, 31 pausadas, sem convenção de nome
- Lead medido por clique no botão: 260 em agosto para 92 orçamentos no CRM
- Telefone, WhatsApp e download sem medição
- Moeda escrita em cada tag, "BRL" em nove e "R$" numa
- Publicação direta em produção, sem prévia nem nota de versão
Como ficou em setembro
Depois
- 38 tags, cada uma com acionador nomeado e dono
- generate_lead por evento personalizado após resposta do servidor: 92, igual ao CRM
- phone_click 61, whatsapp_click 340, file_download 1.180
- Moeda e ambiente herdados da configuração compartilhada
- Prévia obrigatória, versão nomeada, publicação por quem não editou
A mudança que mais pesou foi a menos visível: o número de leads que a mídia vê passou a ser o número que o comercial recebe. Com 92 leads e a média histórica de 1 contrato a cada 7 orçamentos, a previsão de 13 contratos no ciclo de 60 dias deixou de parecer pessimista e virou a base do planejamento de mídia B2B.
Exporte hoje a lista de tags do seu contêiner e escreva ao lado de cada uma o acionador e o nome de quem responde por ela. Tag sem dono ou sem acionador nomeado é pausada até alguém explicar o que ela faz; o critério de acerto é zero tags sem resposta em uma semana. O próximo capítulo escreve o contrato que diz ao desenvolvedor o que colocar no dataLayer e quando.
A reorganização da Verde Vivo coube em duas semanas porque seguiu uma ordem fixa: nomes antes de tags novas, variáveis internas ligadas antes de acionadores, prévia antes de versão e versão com nome antes de publicar. O guia abaixo repete essa ordem no seu contêiner, com os nomes de menu que aparecem no GTM hoje.
Guia prático: do contêiner bagunçado à versão publicada com nome
Faça em um espaço de trabalho próprio, nunca no espaço padrão compartilhado. Depois da fusão de agosto de 2026 alguns contêineres mostram a nova página de visão geral; os caminhos abaixo valem para a navegação lateral de Tags, Acionadores, Variáveis e Pastas.
Passo 1: Crie um espaço de trabalho com nome de entrega
Na página inicial do contêiner, abra o menu de três pontos em Alterações pendentes (Pending changes), escolha Gerenciar espaços de trabalho (Manage Workspaces) e clique em adicionar. Nome e descrição dizem o que será entregue: "Leads B2B por evento personalizado".
Deu certo quando: O seletor de espaço de trabalho no topo mostra o nome novo, e o espaço padrão continua sem alterações suas.
Erro comum: Na versão gratuita cabem 3 espaços simultâneos (o padrão e mais 2). Espaço esquecido aberto impede a próxima pessoa de criar o dela.
Passo 2: Adote um padrão de nome e crie pastas
Tag: ferramenta, tipo e evento ("GA4 - Evento - generate_lead"). Acionador: tipo e condição ("CE - lead_aceito", "Clique - link tel"). Variável: tipo e o que devolve ("DLV - form_id", "URL - caminho"). Pastas por área: Consentimento, GA4, Google Ads, Utilitários.
Deu certo quando: Ordenada por nome, a lista de tags agrupa sozinha tudo o que é GA4, tudo o que é Ads e tudo o que é consentimento.
Erro comum: Renomear sem avisar quem mantém a documentação de medição. Registre o nome antigo e o novo na nota da versão.
Passo 3: Ligue as variáveis internas que os acionadores vão usar
Em Variáveis, no quadro Variáveis integradas (Built-In Variables), clique em Configurar (Configure) e marque as de Cliques (Click URL, Click Element, Click Text), Formulários, Histórico e, em Utilitários, Container Version e Environment Name.
Deu certo quando: Na prévia, a aba Variáveis de cada evento mostra Click URL preenchida ao clicar no link do WhatsApp.
Erro comum: Criar uma variável JavaScript personalizada para ler a URL do clique quando a variável interna já existe.
Passo 4: Mande a versão do contêiner junto com os eventos
Na variável de configurações de evento compartilhada, adicione o parâmetro gtm_versao com o valor {{Container Version}}. Registre-o como dimensão personalizada de evento no GA4.
Deu certo quando: No DebugView, cada evento traz gtm_versao igual ao número da última versão publicada.
Erro comum: Esquecer de registrar a dimensão: o parâmetro chega, mas não aparece em relatório nem em exploração.
Passo 5: Rode a prévia e percorra os eventos
Clique em Visualizar (Preview), informe a URL do site e deixe o Tag Assistant abrir a janela conectada. Faça cada ação do contrato de dados: pedir orçamento, clicar no telefone, no WhatsApp, baixar o guia.
Deu certo quando: Em cada evento do painel à esquerda, a tag esperada aparece em Tags disparadas (Tags Fired) uma única vez, e as demais ficam em Tags não disparadas.
Erro comum: Validar só a tag e não o acionador: abra o acionador na prévia e confira qual condição foi atendida, com o valor real da variável.
Passo 6: Publique primeiro no ambiente de homologação
Em Administrador > Ambientes (Environments), clique em Novo e crie "Homologação" com a URL do site de teste. Instale lá o snippet desse ambiente (Ações > Gerar snippet), que leva os parâmetros gtm_auth e gtm_preview.
Deu certo quando: No site de homologação, a variável Environment Name devolve "Homologação" e a tabela de consulta escolhe o ID de medição da propriedade de teste.
Erro comum: Colar o snippet de homologação no site de produção: as tags passam a seguir o ambiente errado sem nenhum aviso.
Passo 7: Envie com nome e descrição, e publique em produção
Clique em Enviar (Submit), escolha Publicar e criar versão, preencha Nome da versão e Descrição da versão e selecione o ambiente em Publicar no ambiente. A descrição diz o que mudou, por que e qual evento conferir.
Deu certo quando: Em Versões (Versions), a linha nova mostra o nome, a data e quem publicou; os outros espaços de trabalho exibem o aviso de que estão desatualizados.
Erro comum: Publicar e esquecer os outros espaços. Quem trabalhava neles precisa clicar em Atualizar e resolver conflitos antes de publicar, ou desfaz a sua mudança.
No fim você tem: Uma versão nomeada em produção, conferida na prévia e em homologação, com a versão do contêiner visível em cada evento do GA4 e um caminho de volta em um clique.
Números e regras do contêiner que mudam o planejamento
| Item | Regra | O que fazer |
|---|---|---|
| Espaços de trabalho | Até 3 simultâneos na versão gratuita (padrão + 2); sem limite no Tag Manager 360 | Um espaço por entrega e um reservado para ajustes pequenos |
| Criar versão | Exige permissão Aprovar ou superior | Separe quem edita (Editar) de quem publica (Publicar) |
| Fluxo de aprovação | Solicitar aprovação com aprovador escolhido existe só no Tag Manager 360 | Na versão gratuita, a aprovação é combinada fora da ferramenta e registrada na descrição |
| Ambiente Live | Todo contêiner tem e aponta sempre para a versão publicada | Ambientes extras só para homologação e desenvolvimento |
| Reversão | Em Versões, escolha a anterior e publique; Definir como versão mais recente copia o conteúdo para o rascunho | Publicar a anterior quando algo quebrou; copiar para rascunho quando for corrigir |
Fonte: Google Tag Manager Help: Workspaces (answer/7059647), Environments (answer/6311518), Preview, publish and versions (answer/6107163)
Contêiner que a próxima pessoa entende
Espaço de trabalho serve para separar entregas, não pessoas; o nome diz o que vai ao ar.
- Simo Ahava: workspace é gestão de mudança, não de usuários; um por funcionalidade.
- Simo Ahava: deixe um espaço só para ajustes pequenos e urgentes.
- Simo Ahava: antes de atualizar o espaço, revise o que a versão nova trouxe.
- Measureschool: nomeie tag por ferramenta, tipo e evento, e variável pelo que devolve.
- Se não dá para nomear o espaço em poucas palavras, a entrega está grande demais.
O teste: Abra a lista de tags ordenada por nome: dá para achar o lead B2B em 10 segundos?
alexandrecaramaschi.com/educacao/frontends-com-vibecoding
Pegadinha comum: publicar direto do espaço padrão enquanto outra pessoa tem um espaço aberto. A versão sai correta, mas o outro espaço continua com a base antiga; se essa pessoa publicar sem clicar em Atualizar e revisar os conflitos marcados em vermelho, a sua mudança some da produção.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Cobre no relatório os números certos e ignore o restosugerido pelo grafoApresenta o conceito “Google Tag Manager”, usado em “Organizar o Tag Manager para que a tag certa dispare uma vez”.
- Python no marketing, caso 2: relatório do GA4 por canal com a Data APIsugerido pelo grafoApresenta o conceito “Google Analytics 4”, usado em “Organizar o Tag Manager para que a tag certa dispare uma vez”.
- CursoPython: Programação do Zerosugerido pelo grafo21 capítulos de “Google Analytics 2027” usam conceitos apresentados em “Python: Programação do Zero”.
- CursoGoogle Ads 2027sugerido pelo grafo4 capítulos de “Google Analytics 2027” usam conceitos apresentados em “Google Ads 2027”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Google Ads 2027Levar a venda do CRM de volta ao Google Ads pelo Data ManagerExaminar conexões de Levar a venda do CRM de volta ao Google Ads pelo Data Manager
- LinkedIn Ads 2027Instalar o Insight Tag e conferir cada conversão no navegadorExaminar conexões de Instalar o Insight Tag e conferir cada conversão no navegador
Voltar ao capítulo anterior: Instalar a Google tag uma vez só e validar a coleta
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Google Analytics 2027
- 04Desenhar conta, propriedade e fluxo para o negócio que existe
- 05Instalar a Google tag uma vez só e validar a coleta
- 06Organizar o Tag Manager para que a tag certa dispare uma vez
- 07Escrever o contrato de dados que o desenvolvedor consegue implementar
- 08Registrar dimensões personalizadas sem estourar a cardinalidade