Instalar a Google tag uma vez só e validar a coleta

Com a propriedade e o fluxo desenhados, a coleta começa por um trecho de código que precisa existir em toda página, uma vez só. É a etapa que parece mais simples e a que mais produz relatório errado: uma Google tag instalada duas vezes conta cada visita em dobro, e nenhum aviso aparece na tela.

O custo é silencioso. Visualizações por sessão, taxa de engajamento e taxa de conversão saem distorcidas ao mesmo tempo, e a equipe passa meses comparando um mês inflado com outro. Quando alguém desconfia, o histórico já não presta para comparação, e a decisão sobre orçamento de mídia foi tomada em cima do número dobrado.

A tag é uma decisão de arquitetura: qual identificador vai no código, por qual método ela entra em cada plataforma, o que a medição otimizada registra sozinha e como provar que a coleta aconteceu uma vez. A Verde Vivo chegou aqui com três instalações e saiu com uma, e os números do e-commerce mudaram de tamanho sem que uma venda a mais ou a menos tivesse acontecido.

Três identificadores convivem, e a confusão entre eles gera metade dos chamados de suporte. O ID da propriedade é o número que identifica a propriedade no Admin e nas APIs. O ID do fluxo identifica cada fluxo de dados (web, Android, iOS) dentro dela. O ID de medição (Measurement ID, o código que começa com G- e aponta para o fluxo web) é o único que vai no site: o navegador só conhece esse.

A tag entra no site por um de três métodos, e a regra é escolher um. O código direto (o trecho gtag.js colado no cabeçalho de todas as páginas) é o mais simples e o mais difícil de mudar depois. O Google Tag Manager (GTM, o contêiner que decide quais tags disparam e quando) carrega a Google tag por dentro e centraliza tudo o que vem depois. A integração nativa (o campo da plataforma onde se cola o ID de medição) instala sem código.

A fusão de 20 de agosto de 2026 muda a tela, não a regra. A Google tag virou um contêiner GTM completo, com uma seção Settings e uma aba Advanced, e passou a enviar dados direto a destinos do Google sem JavaScript extra. O tagueamento visual (marcar um botão na página como conversão sem escrever código) chegou em beta, só para conversões de compra no Google Ads, com expansão prometida ao longo do ano. O upgrade é opcional e chega por convite; quem não foi convidado continua na tela antiga.

Em cada plataforma, a pergunta é a mesma: por onde a tag já está entrando? No WordPress, temas e plugins costumam trazer um campo para o ID de medição, e dois plugins com o mesmo campo preenchido são duas tags. Na Shopify, a integração nativa do Google instala a tag em toda a loja, inclusive no checkout, onde código de tema não chega. Nos construtores de site, o campo de "Google Analytics" nas configurações faz o mesmo papel, e o código colado à mão por cima dele vira a segunda cópia.

A medição otimizada (o conjunto de eventos que a Google tag registra sem código, ligado por padrão no fluxo web) responde por boa parte do que os relatórios mostram. Ela registra page_view a cada carregamento, scroll quando a pessoa chega ao fim da página, click em link que leva para fora do domínio, file_download em link de arquivo, view_search_results quando a URL traz o parâmetro de busca interna, video_start e video_progress em vídeo do YouTube incorporado, e form_start com form_submit em formulários.

O que ela não sabe define o trabalho dos próximos capítulos. O form_submit dispara no envio do formulário, tenha o servidor aceitado ou não; o evento não conhece o valor do pedido, o segmento do lead nem se a pessoa era cliente. O vídeo só conta se o player for do YouTube com a API de JavaScript ativa. A busca interna só é reconhecida se o nome do parâmetro na URL bater com a lista configurada. Tudo o que envolve dinheiro, identidade ou etapa do negócio vem do contrato de dados do capítulo 7.

Prevenir a duplicidade é uma rotina, não um ajuste único. A cada plugin instalado, tema trocado ou agência contratada, alguém confere quantas Google tags a página carrega. O Tag Assistant (a extensão e o painel do Google que listam as tags encontradas na página) mostra duas entradas com o mesmo ID de medição quando há duas cópias. O DebugView (a tela do GA4 que exibe os eventos de um aparelho em tempo real) mostra dois page_view para um único carregamento.

O Tag Diagnostics (o painel de diagnósticos e recomendações da Google tag, disponível desde outubro de 2024) aponta parte disso sem ninguém pedir: Google tag mal configurada, tag de evento sem Google tag na página e CDN como a Cloudflare sem o modo first-party. Cada alerta pode ser dispensado, e uma equipe que dispensa alerta para limpar a tela perde o único aviso automático que existe.

A cobertura de tags (Tag coverage, a lista de páginas em que o Google detectou ou espera a tag) completa o diagnóstico. Páginas detectadas entram sem o rótulo "Suggested"; páginas sem sinal por 60 dias saem da lista; e o diagnóstico de páginas não tagueadas mostra onde a coleta falha. Um site em Next.js com uma rota nova que esqueceu o layout comum aparece ali antes de aparecer no relatório.

O Google tag gateway (a opção de servir a Google tag pelo próprio domínio do site, via CDN ou balanceador de carga, em vez de pelo domínio do Google) entra aqui porque muda a instalação. A tag continua uma só, mas passa a ser carregada de um endereço próprio, o que bloqueadores e navegadores tratam com menos restrição. As datas de chegada em cada provedor se espalharam por 2025 e 2026.

Armadilha comum: instalar a tag pelo plugin "para garantir" enquanto o GTM já carrega a mesma tag. As duas cópias disparam page_view no mesmo instante, com o mesmo ID de cliente, e o relatório de páginas dobra sem que a contagem de sessões dobre junto. A distorção fica escondida em métricas de razão: visualizações por sessão sobem, e a taxa de engajamento muda sem motivo aparente.

A Verde Vivo tinha exatamente isso. Caio havia colado o gtag.js no layout do site em Next.js em 2024. Uma agência instalou depois um contêiner GTM com a Google tag dentro, sem remover o código. Na loja Shopify, a integração nativa do Google estava ligada e o tema trazia o mesmo contêiner GTM injetado à mão. Três pontos de instalação, e cada página do site e da loja disparava page_view duas vezes.

O sintoma que Marina viu foi uma razão estranha: 3,0 visualizações por sessão no site, com 212.000 visualizações e 71.000 sessões em agosto, para um catálogo em que a maioria das pessoas vê a home, uma página de produto e o carrinho. O Tag Assistant na home listou duas Google tags com o mesmo ID de medição, e o DebugView mostrou dois page_view para um único carregamento.

A correção seguiu a regra de um método por superfície. No site, Caio removeu o gtag.js do layout e o GTM ficou como único caminho. Na loja, a integração nativa ficou e a Google tag foi removida do contêiner injetado no tema, que continuou publicando só as tags de evento. Nas duas semanas seguintes, comparadas às mesmas duas semanas do mês anterior, as sessões ficaram em 34.000 nos dois períodos e as visualizações caíram de 103.000 para 53.000.

O que mudou para a Verde Vivo foi a régua, não o negócio: 1.650 pedidos sobre 71.000 sessões seguem dando 2,3 por cento de conversão, mas as páginas de produto que pareciam ter o dobro de leitura voltaram ao tamanho real, e a comparação com setembro passou a valer. Marina registrou a data da correção como anotação na propriedade, para que ninguém compare agosto com setembro sem saber por que as visualizações caíram pela metade.

Abra o Tag Assistant na home do seu site e conte quantas Google tags aparecem com o mesmo ID de medição: o critério é uma. Faça o mesmo numa página de produto e na página de obrigado, e confira no DebugView que cada carregamento gera um page_view. O próximo capítulo entra no contêiner e organiza tags, acionadores e variáveis para que cada evento dispare uma vez.

Com uma Google tag por superfície, a Verde Vivo ainda tinha de decidir o que essa tag faz sozinha e provar, página por página, que cada carregamento gera um evento. O guia abaixo é o roteiro que Caio passou a rodar a cada publicação do contêiner e a cada troca de tema na loja.