Configurar o GA4 via Google Tag Manager parece trivial até você se deparar com "(not set)" nos relatórios, dados de sessão inflados ou conversões que somem sem explicação. A maioria desses problemas tem origem em um detalhe de configuração que passa despercebido — principalmente a questão do pageview duplicado, que aparece com frequência surpreendente mesmo em implementações feitas por profissionais experientes.
Este artigo cobre a configuração correta do GA4 no GTM do início ao fim. Para uma visão dos erros mais comuns no GTM de forma geral, incluindo problemas de GA4, veja os 7 erros mais comuns no Google Tag Manager, ou o guia completo de auditoria de container GTM.
Google Tag vs tag de GA4 Configuration — qual usar
Existe uma mudança importante que muita gente ainda não incorporou: a tag recomendada atualmente para o GA4 é o "Google Tag" (tipo de tag específico no GTM), não a tag de "GA4 Configuration" que era o padrão anterior.
O Google Tag é mais robusto, suporta múltiplas propriedades e tem comportamentos mais previsíveis em relação ao pageview automático. Se você está fazendo uma nova implementação, use o Google Tag. Se já tem GA4 Configuration instalado, funciona — mas vale entender as diferenças para saber onde estão os riscos.
A diferença prática mais importante: o Google Tag envia um pageview automaticamente quando dispara (comportamento padrão). A tag de GA4 Configuration também pode fazer isso dependendo da configuração. O problema acontece quando você tem ambas ativas ou quando adiciona uma segunda tag de pageview separada.
Passo a passo: configurar o GA4 via Google Tag no GTM
1. Crie a tag Google Tag
No GTM, Tags → Nova → selecione o tipo "Google Tag". No campo Tag ID, insira o seu Measurement ID do GA4 — formato G-XXXXXXXXXX. Você encontra esse ID no GA4 em Administrador → Fluxos de dados → selecione o fluxo do seu site.
2. Configure o trigger como All Pages
O Google Tag deve disparar em todas as páginas. Selecione o trigger "All Pages" (ou "Initialization - All Pages" se quiser garantir que ele seja o primeiro a disparar). Nomeie a tag de forma descritiva: "Google Tag — GA4 Base".
3. Confirme que não há segunda tag de pageview
Esse é o passo mais crítico. Depois de salvar o Google Tag, revise o container e identifique se há qualquer outra tag que possa estar enviando pageview para o GA4:
- Tag de "GA4 Configuration" com All Pages trigger
- Tag de "GA4 Event" com nome
page_view - gtag.js instalado diretamente no código do site além do GTM
Se encontrar qualquer uma dessas, pause ou remova antes de publicar. O pageview duplicado é um dos erros mais comuns e mais prejudiciais — veja como identificar tags duplicadas no GTM para o processo completo.
4. Verifique via DebugView no GA4
Com o GTM em Preview Mode, navegue pelo site e abra o DebugView no GA4 (Administrador → DebugView — você verá o dispositivo de debug aparecer na lista). Confirme que cada página que você visita gera exatamente um evento page_view no DebugView. Se aparecerem dois para cada visita, você tem duplicação.
Configurar eventos de conversão no GA4
No GA4, eventos de conversão não são configurados no GTM — são configurados diretamente dentro do Google Analytics. O fluxo é:
- Configure o evento no GTM (tag de GA4 Event que dispara no momento certo)
- Confirme que o evento está chegando no GA4 via DebugView
- No GA4, vá em Administrador → Conversões → Novo evento de conversão → insira o nome do evento
Obs.: o GA4 leva até 24 horas para começar a contabilizar um novo evento como conversão. Durante esse período, o evento aparece no relatório de eventos mas não no relatório de conversões.
Configurar parâmetros de evento no GA4 via GTM
Eventos do GA4 suportam parâmetros customizados que enriquecem os dados no relatório. Para adicionar parâmetros, crie uma tag de "GA4 Event" no GTM (não o Google Tag base — uma tag separada para o evento específico) e adicione os parâmetros na seção "Parâmetros de evento".
Exemplo: evento de purchase com parâmetros corretos
Para um evento de compra completo:
- Event Name:
purchase - Parâmetro transaction_id: variável de DataLayer com o ID único da transação
- Parâmetro value: variável de DataLayer com o valor total da compra
- Parâmetro currency:
BRL(ou variável se for dinâmico) - Parâmetro items: variável de DataLayer com o array de produtos
- Trigger: evento personalizado de DataLayer que dispara após a confirmação de compra
Para os parâmetros aparecerem nos relatórios personalizados do GA4, você precisa registrá-los em Administrador → Definições de evento → Criar definições de evento personalizado. Sem isso, eles chegam no GA4 mas ficam invisíveis nos relatórios.
Por que "(not set)" aparece no GA4 e como resolver
"(not set)" é o valor padrão do GA4 quando um campo esperado chega vazio. As causas mais comuns:
(not set) na dimensão de canal (Default Channel Grouping)
Aparece quando o GA4 não consegue classificar a origem do tráfego. Causas: links sem UTM onde deveria ter, UTM com valores não reconhecidos pelo mapeamento de canais do GA4 (utm_medium com valor fora do padrão), ou tráfego chegando de domínios que deveriam estar na lista de domínios de referência excluída.
(not set) em parâmetros de evento
Aparece quando a variável do GTM retorna undefined ou vazio. Verifique o caminho da variável no GTM, confirme que o DataLayer está sendo populado antes do evento disparar, e use o DebugView para ver os valores reais de cada parâmetro no momento do evento.
(not set) em dimensões de e-commerce
Aparece quando os eventos de e-commerce chegam sem o objeto items correto ou sem os campos obrigatórios. O item_id e item_name são obrigatórios para relatórios de produto. Veja o artigo sobre eventos de e-commerce obrigatórios no GA4 para a estrutura completa do objeto items.
Como verificar a implementação GA4 via DebugView
O DebugView é a ferramenta mais útil para validar a implementação GA4 em tempo real. Para usar:
- Ative o Preview Mode no GTM
- No GA4, abra Administrador → DebugView
- Aguarde o dispositivo de debug aparecer na lista (pode levar 1-2 minutos)
- Navegue pelo site e observe os eventos chegando em tempo real no DebugView
- Clique em qualquer evento para ver todos os parâmetros enviados
O DebugView mostra eventos com delay de poucos segundos — é a forma mais confiável de confirmar que a tag está funcionando corretamente antes de publicar o container.
FAQ
Qual a diferença entre Google Tag e GA4 Configuration no GTM?
O Google Tag é o tipo de tag mais recente, recomendado pelo Google para novas implementações. Suporta múltiplas propriedades GA4 e gtag.js nativo. A GA4 Configuration é o tipo anterior, ainda funcional mas que será descontinuado. Para novas implementações, sempre use o Google Tag. Para implementações existentes com GA4 Configuration, funciona, mas avalie migrar em um momento de manutenção.
Preciso de uma tag separada de pageview ou o Google Tag já resolve?
O Google Tag já envia pageview automaticamente. Não crie uma tag separada de pageview para o GA4 além do Google Tag base — isso gera duplicação. Se precisar rastrear mudanças de URL em Single Page Applications, use o trigger de History Change no GTM, mas ainda com cuidado para não duplicar com o pageview automático do Google Tag.
Meu GA4 mostra muito mais sessões do que o analytics do servidor. O que está errado?
Causas possíveis: pageview duplicado no GTM (a mais comum); gtag.js instalado diretamente no código do site além do GTM; tag de GA4 Configuration e Google Tag ativas ao mesmo tempo. Use o DebugView para confirmar quantos page_view chegam por navegação — deveria ser exatamente 1 por página.
Como registrar um evento de conversão que não está chegando no relatório de conversões do GA4?
Verifique na sequência: (1) o evento está chegando no DebugView? Se não, o problema está no GTM. (2) O evento está registrado em Administrador → Conversões no GA4? Se não, adicione lá. (3) Aguardou 24 horas? O GA4 tem delay de processamento para conversões. Se o evento não aparece no DebugView, revise o trigger e a tag no GTM usando o Preview Mode.