Instalar o GA4 pelo Google Tag Manager

Adicione uma tag do Google pelo Google Tag Manager, teste no Preview e confirme que o GA4 recebe uma visualização normal de página após a publicação.

• Resultado: Rastreamento e mensuração
• Ferramentas: Google Tag Manager, Google Analytics 4, Google Tag Assistant
• Responsável: Pessoas encarregadas de adicionar o Google Analytics ao site e autorizadas a publicar seu contêiner do Tag Manager
• Tempo estimado: 35 minutos

Escopo

Este SOP abrange:

• Um site cujas páginas carregam separadamente
• Um fluxo Web existente do GA4 e um contêiner Web instalado
• Eventos automáticos de carregamento, verificações no Preview, recebimento em produção e diagnósticos da tag

Não abrange:

• Criar contas, propriedades, fluxos ou concessões de acesso
• Instalar o contêiner do Tag Manager no site
• Configurar controles de consentimento ou decidir requisitos de privacidade
• Mensuração otimizada, aplicações de página única, eventos personalizados e eventos principais
• Campanhas, relatórios ou análise de atribuição
• Adicionar um destino a uma tag do Google existente

Pré-requisitos

• Acesso Editor à propriedade e ao fluxo Web existentes do GA4 para este site, com Enhanced measurement desativado
• Acesso Publish ao contêiner Web instalado do Google Tag Manager, sem tag do Google ativa no site
• ID do contêiner GTM instalado e URLs de duas páginas públicas do site que carreguem separadamente e não contenham informações pessoais
• Configuração de privacidade e consentimento estabelecida que cubra GA4 e a tag do Google, incluindo como realizar uma visita com analytics habilitado

SOPs relacionados

• SOP 010: Criar uma propriedade GA4 e um fluxo de dados Web
• SOP 001: Instalar o Google Tag Manager no WordPress com o Site Kit
• SOP 011: Criar uma conta e um contêiner Web no Google Tag Manager
• SOP 008: Criar URLs de campanha com UTMs consistentes

01. Verificar o destino e a configuração existente

1. Abra o Google Analytics. Selecione a propriedade, abra Admin → Data streams e escolha o fluxo Web do site. Confira a URL e se Enhanced measurement está desativado. Crie ou abra uma Nota de entrega da mensuração para esta configuração. Copie para ela o Measurement ID do fluxo, iniciado em G-.

   • Atenção: Se a URL ou as configurações de mensuração diferirem da configuração inicial prevista, pare antes de adicionar a tag.

2. Abra o Google Tag Manager e selecione o contêiner Web instalado. Compare o ID GTM- com o do site. Revise Workspace Changes e abra Tags para procurar uma tag do Google ou configuração GA4 existente. Se houver tags antigas mantidas, confirme que estão Paused.

   • Atenção: Continue somente sem alterações pendentes não relacionadas e sem tag do Google ativa. Este procedimento é de primeira instalação; a publicação inclui todas as alterações do workspace.

3. Confirme que o contêiner publicado é o ponto de partida e que as páginas em produção ainda não executam uma tag do Google ativa.

   • Atenção: Se outra tag do Google ou destino Analytics aparecer, pare antes de adicionar uma instalação.

   1. Abra o Tag Assistant, conecte à primeira URL e siga o fluxo normal de consentimento para uma visita com analytics habilitado.

   2. Selecione o contêiner GTM. Em Container Version, abra o seletor de versões, escolha Debug para o ambiente Live e clique em Reload page. Confirme que Container Version mostra Live.

   3. Inspecione as tags detectadas na primeira página e abra a segunda na mesma sessão. Confirme que o contêiner GTM esperado carrega nas duas e que não aparece tag do Google ativa ou destino Analytics.

   4. Clique em Stop debugging ao concluir a verificação inicial.

02. Adicionar a tag do Google

1. No workspace GTM, escolha Tags → New. Nomeie a tag Google tag – GA4. Em Tag Configuration, selecione Google tag e cole o ID de mensuração G- em Tag ID. Em Triggering, escolha Initialization – All Pages e salve. Reabra a tag e confira se Tag ID corresponde ao passo 1.1 e se o acionador é Initialization para todas as páginas.

   • Atenção: Não adicione uma tag separada de evento page_view.

03. Testar antes de publicar

Confira os filtros de dados ativos da propriedade antes dos testes. Para a verificação normal no Realtime, use uma rede de teste aprovada que não seja excluída por um filtro de tráfego interno; não desative exclusões de produção para fazer o teste passar. Registre a rede e o estado dos filtros junto das evidências.

1. Teste uma tag do Google em dois carregamentos completos de página no Preview. O Tag Assistant mostra o que o rascunho enviou; a confirmação normal de recebimento no GA4 Realtime virá depois.

   • Atenção: Pare antes de publicar se a tag falhar, enviar para outro destino ou enviar visualizações duplicadas.
   • Atenção: Preview e Tag Assistant mostram o envio do rascunho. O GA4 Realtime confirma uma visita normal; DebugView é destinado a visitas de depuração e não substitui a verificação posterior no Realtime.

   1. Clique em Preview no GTM. Informe a primeira URL, clique em Connect e volte ao Tag Assistant para clicar em Continue. Siga o fluxo normal de consentimento.

   2. Selecione o evento Initialization da página e confirme que a tag disparou uma vez. Selecione o destino da tag do Google e inspecione o evento page_view, o registro de carregamento do GA4. Compare o ID G- e page_location com o fluxo e a primeira página.

   3. Abra a segunda página na mesma sessão e repita as verificações de Initialization, destino, ID G-, page_location e page_view.

   4. Registre na nota as duas URLs verificadas e o resultado de um page_view por carregamento completo.

04. Publicar e verificar o site em produção

Antes de publicar, registre na Nota de entrega da mensuração a aprovação do responsável para a alteração testada e a versão GTM atualmente em produção. Se as verificações falharem devido a esta publicação, peça ao publicador autorizado que restaure a versão registrada e repita os testes. Revise publicações intermediárias antes de restaurar uma versão para não perder alterações de outras pessoas.

1. No GTM, clique em Submit e escolha Publish and Create Version. Revise as alterações: somente a tag do Google testada deve estar incluída. Adicione nome e descrição da versão e clique em Publish. Abra a versão publicada e confira se a tag salva mantém seu ID G- e o acionador Initialization para todas as páginas. Registre o número da versão na nota.

2. Confira se o contêiner publicado envia visualizações sem depender do rascunho do workspace.

   1. Em Versions no GTM, confirme que o número da versão do passo 4.1 está marcado como Live.

   2. Encerre o Preview em Stop debugging e feche a janela do site em teste. Inicie uma conexão nova pelo Tag Assistant com a primeira página. Selecione o contêiner GTM, abra o seletor em Container Version, escolha Debug para Live e clique em Reload page. Confirme que Container Version mostra Live.

   3. Siga o consentimento normal. Selecione o destino da tag do Google na primeira página e confira um page_view para seu ID G-. Abra a segunda página na mesma sessão e repita.

   4. Clique em Stop debugging e feche a janela conectada ao concluir a verificação Live.

3. Confirme no Realtime que o GA4 recebeu uma visita normal, fora da depuração.

   • Atenção: Se não for possível identificar as duas páginas, a instalação está incompleta. Confira propriedade, destino e fluxo normal de consentimento sem contornar os controles de privacidade.

   1. No GA4, abra Reports → Realtime overview e anote na nota a contagem atual de page_view e o horário antes de abrir as páginas de teste.

   2. Abra as duas URLs em uma aba normal e siga o consentimento do site. Use um rótulo de consulta exclusivo e não pessoal em cada URL: acrescente ?check= seguido de um rótulo curto de sua escolha, ou &check= se a URL já tiver ponto de interrogação. Confirme que ambas carregam normalmente e mantêm o rótulo na barra de endereço.

   3. Volte ao Realtime e atualize. Em Event count by Event name, clique em page_view e depois page_location. Encontre as duas URLs completas com seus rótulos e confirme um novo evento para cada. O Realtime comprova esta visita normal; DebugView é para depuração e não substitui a verificação. Aguarde até 15 minutos para a coleta inicial e atualize antes de concluir.

   4. Se os rótulos desaparecerem ou as páginas pararem de funcionar, use duas URLs identificáveis e relacione seus novos eventos em View user snapshot. Se não conseguir identificar ambas, pare e confira propriedade, destino e consentimento normal sem contornar controles de privacidade.

4. No GA4, volte a Admin → Data streams, abra o fluxo Web e escolha Configure tag settings. Leia Tag quality e abra View diagnostics se houver problemas listados. Registre na nota o status e eventuais problemas de coleta. Trate coleta bloqueada, ausente ou interrompida como instalação incompleta. Recomendações por si só não invalidam o resultado; um status pendente não substitui a verificação dos eventos.