O que é a tag do Google
A tag do Google é o código gtag.js que envia dados de navegação do site para produtos do Google, como Google Analytics 4 e Google Ads. Cada produto que recebe esses dados é um destino da tag, e uma mesma tag pode ter vários destinos (documentação da tag do Google ↗[1]).
Na prática, você vai lidar com três formatos de identificador. O ID de métricas do Google Analytics 4 começa com G- e fica no fluxo de dados da web. O de Google Ads começa com AW-. E o Site Kit, ao configurar o Analytics, cria uma tag do Google com prefixo GT- quando o site ainda não tem uma. No WordPress, a tag pode entrar por plugin, pelo tema ou por um gerenciador. Para escolher entre eles, ajuda entender como núcleo, tema e plugins se dividem, assunto do guia sobre o que é WordPress. Qualquer que seja o caminho, a instalação segue a regra da Ajuda do Tag Manager: uma tag do Google por página, e, se já existe uma, os novos destinos entram nela (Ajuda do Tag Manager ↗[2]).
Qual método escolher
| Método | Indicado para | Onde o código fica | Quem mantém |
|---|---|---|---|
| Site Kit by Google | Site que precisa de Analytics, Search Console e, se for o caso, Ads e AdSense, sem mexer em código | Plugin posiciona a tag automaticamente | Administrador do WordPress |
| Google Tag Manager | Site com várias tags, eventos personalizados e pixels de terceiros | Dois trechos no tema, o resto dentro do contêiner | Marketing, com apoio técnico na instalação |
| gtag.js no tema | Site com tema próprio e equipe de desenvolvimento, com poucas tags | Tema filho ou plugin próprio, pelo hook wp_head | Desenvolvedor |
O que a experiência da Studio Visual mostra
Na Studio Visual, instalar e corrigir GA4, Tag Manager e pixels faz parte da rotina dos sites WordPress que a gente desenvolve e mantém. Boa parte dos chamados de medição que recebemos nasce de tag duplicada ou instalada no lugar errado.
Em janeiro de 2025, a Acraft, loja WooCommerce de cervejas artesanais com assinatura, parou de enviar conversões ao Meta Ads. A medição estava dividida: GA4 e Google Ads saíam pelo Tag Manager, e o pixel da Meta, por um plugin próprio. A equipe levantou os eventos que o plugin registrava, recriou os eventos de conversão da Meta dentro do contêiner e validou cada disparo antes de remover o plugin, o que deixou um único caminho para todas as tags. Em outro cliente, em 2022, o pedido de suporte já chegou com o diagnóstico: a tag do Google Analytics tinha sido instalada duas vezes, e bastou localizar e remover a duplicata.
Requisitos antes de começar
- Pegue o ID. No Google Analytics 4, vá em Administrador > Coleta e modificação de dados > Fluxos de dados, abra o fluxo da web e copie o ID de métricas (Ajuda do Analytics ↗[3]). No Tag Manager, o ID do contêiner começa com GTM-.
- Descubra se já existe tag no site. Abra o código-fonte da página no navegador e procure por googletagmanager.com. Se o endereço aparecer, identifique de onde vem a tag (tema, plugin, Site Kit ou código manual) antes de instalar outra.
- Confirme o acesso: administrador no WordPress, administrador ou editor na propriedade do GA4 e, para o Tag Manager, permissão de publicar no contêiner.
- Faça backup do site se o método escolhido envolve editar arquivos do tema, e prefira testar numa cópia de homologação; os passos de como instalar WordPress servem para montar essa cópia.
Como instalar pelo Site Kit
O Site Kit by Google é o plugin oficial do Google para WordPress. Ele conecta Search Console, Analytics, Tag Manager, Ads, AdSense e PageSpeed Insights ao painel (página do plugin ↗[4]).
- Em Plugins > Adicionar novo, procure por Site Kit by Google, instale e ative. Pelo WP-CLI, o equivalente é
wp plugininstall google-site-kit –activate. - Rode a configuração inicial e entre com a conta Google que tem acesso às propriedades.
- Em Site Kit > Configurações > Conectar mais serviços, escolha Analytics, selecione conta, propriedade e fluxo de dados (ou deixe o plugin criar) e conclua a configuração (documentação do Site Kit, Analytics ↗[5]).
Se o Site Kit detectar um código de Analytics já presente no site, ele avisa e deixa você escolher entre manter o código existente ou deixar o plugin posicionar o dele. A opção de posicionar o código fica em Site Kit > Configurações > Serviços conectados > Analytics > Editar (documentação do Site Kit sobre código posicionado ↗[6]). Fique com um dos dois, pela mesma regra de uma tag por página.
Como instalar pelo Google Tag Manager
O Google Tag Manager é um gerenciador de tags: você instala o contêiner uma vez no site e passa a adicionar, editar e publicar tags pela interface dele.
- Crie a conta e o contêiner da web em tagmanager.google.com.
- Instale os dois trechos de código do contêiner. O primeiro vai o mais alto possível dentro do ; o segundo, logo depois da abertura do (Ajuda do Tag Manager, instalar contêiner ↗[7]). No WordPress, há três formas de fazer isso. O módulo Tag Manager do Site Kit posiciona o código sem edição manual. Um plugin de inserção de código também resolve, desde que você revise o campo inteiro antes de salvar: ele costuma acumular códigos de várias pessoas, e um trecho colado errado vai para todas as páginas. A terceira é o tema filho, com os hooks wp_head e wp_body_open. O hook wp_body_open existe desde o WordPress 5.2 e só funciona se o tema chamar a função logo após a abertura do (referência do wp_body_open ↗[8]).
- Dentro do contêiner, crie uma tag do tipo Tag do Google, informe o ID (G- do Analytics) e use o acionador Inicialização: todas as páginas (Initialization – All Pages, na interface em inglês) (Ajuda do Tag Manager, tag do Google ↗[9]).
- Clique em Visualizar (Preview), informe a URL do site e conecte o Tag Assistant para ver se a tag dispara.
- Clique em Enviar, escolha Publicar e criar versão, dê nome à versão e publique (Ajuda do Tag Manager, verificar e publicar ↗[10]). Uma versão criada e não publicada deixa a mudança fora do site.
Com o Tag Manager instalado, tire a tag do Analytics de qualquer outro lugar do site. Para quem usa o Site Kit junto com o Tag Manager, a documentação do plugin recomenda conectar o Analytics pelo módulo próprio do Site Kit, que acrescenta dimensões personalizadas aos dados, e deixar o contêiner para as demais tags (documentação do Site Kit, Tag Manager ↗[11]).
Como instalar o gtag.js direto no tema
O snippet do gtag.js deve ficar logo depois da abertura do
, em todas as páginas medidas (documentação da tag do Google ↗[1]). No WordPress, o caminho seguro é registrar uma função PHP no hook wp_head, dentro dofunctions.php de um tema filho ou num plugin próprio. Use prioridade 1 no hook para o código sair cedo no , já que no WordPress número menor roda antes. Quem opta pelo plugin próprio encontra a estrutura mínima no conteúdo sobre criar plugin WordPress.
O exemplo abaixo serve para um plugin próprio ou para o functions.php do tema filho. No teste em WordPress 7.1.3 com PHP 8.3, em 14/10/2026, ele colocou a tag uma única vez, no início do
“`php
/**
- Plugin Name: Tag do Google
*/
add_action( ‘wp_head’, ‘sv_tag_do_google’, 1 );
function sv_tag_do_google() {
$id = ‘G-XXXXXXXXXX’; // ID de métricas do fluxo de dados do GA4.
?>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', '');
}
`
Muitos tutoriais antigos sugerem editar o header.php do tema principal, o que funciona até a próxima atualização do tema. Segundo a documentação de temas do WordPress, o tema filho existe para permitir atualizar o tema pai sem perder modificações, e o functions.php do filho é carregado junto com o do pai (documentação de temas filhos ↗[13]).
Como medir conversões de anúncios com a mesma tag
Quando o site já tem a tag do Google para o Analytics, a conta do Google Ads entra como mais um destino dela, sem outra tag instalada. Na tela da tag do Google, em Administrador > Gerenciar tag do Google, a seção Destinos tem a opção de adicionar destino, que exige papel de administrador (Ajuda do Google Ads ↗[14]). A ação de conversão em si fica no Google Ads. No painel, vá em Metas > Resumo e clique em + Criar ação de conversão. Em Conversões em um site, informe o domínio e clique em Verificar, para o Google Ads procurar a tag do Google já instalada. Depois escolha a categoria da conversão e a forma de medir: pela tag do Google, sem código (pela URL da página de confirmação) ou com código (para cliques e valores), pelo Tag Manager ou importando um evento do Google Analytics 4 (Ajuda do Google Ads, ações de conversão ↗[15]). Como os nomes de menu do Google Ads mudam com frequência, confira o caminho na sua conta antes de seguir.
OPINIÃO DE ESPECIALISTA
“Quando a medição de um site WordPress falha, quase sempre o caminho do cliente que precisa ser medido passa por fora do WordPress. Já corrigi loja com assinatura em que o evento de pagamento disparava em dobro para duas plataformas de mídia, e atendi projeto em que o visitante saía do site institucional para o aplicativo e a origem dele se perdia na passagem, o que exigiu medição entre domínios. Se o funil principal roda num aplicativo ou num checkout de terceiros e o WordPress é só a vitrine, eu desenho a medição a partir desse sistema e trato o site como mais uma origem de dados. Centralizar tudo no WordPress, nesse cenário, só muda a complexidade de lugar.”
João Pedro Tibério
Líder Técnico, Infraestrutura e Confiabilidade (DevOps e IA)
Como validar a instalação
- Relatório Tempo real do GA4: abra o site em outra aba e confira se a visita aparece. A Ajuda do Analytics informa que a coleta pode levar até 30 minutos para começar.
- Tag Assistant: pelo botão Visualizar do Tag Manager, a interface mostra quais tags dispararam, em que ordem e com qual acionador.
- DebugView do GA4: com o modo Visualizar do Tag Manager ou o Tag Assistant ativo, os eventos do seu navegador aparecem em Administrador > Exibição de dados > DebugView (Ajuda do Analytics, DebugView ↗[16]).
- Código-fonte: procure gtag/js?id= e GTM- na página publicada. Cada ID precisa aparecer uma vez.
- Site Kit: a tela de configurações informa se o plugin está posicionando o código ou se detectou uma tag existente.
A metatag de verificação do Search Console comprova a posse do site, e quem mede as visitas é a tag do Google. O próprio Search Console aceita a tag do Analytics ou o contêiner do Tag Manager já instalados como forma de verificação (Ajuda do Search Console ↗[17]).
Faça o teste com o cache do site limpo e sem estar logado: há plugins de cache que servem uma versão antiga do HTML e temas que omitem scripts para administradores.
Quanto tempo leva
A coleta de dados no GA4 pode levar até 30 minutos para começar depois da instalação, segundo a Ajuda do Analytics ↗[3]. Já o tempo de cada etapa da instalação depende do método e dos acessos disponíveis. Pela experiência de projeto da Studio Visual, o Site Kit é um fluxo guiado de minutos, sem edição de código. Entre os métodos com código, a etapa mais curta é instalar só o contêiner do Tag Manager no tema e validar no modo Visualizar. Criar o contêiner e configurar GA4 e Search Console num site novo, com validação no Visualizar, no DebugView e no Tag Assistant, toma um pouco mais. Eventos personalizados no Tag Manager, eventos de compra de loja WooCommerce e a troca de um plugin de pixel por tags no contêiner levam várias vezes esse tempo, porque exigem levantamento e validação de cada disparo.
Erros comuns e o que fazer quando dá errado
- Tag em dobro: Site Kit posicionando o código e, ao mesmo tempo, o gtag.js colado no tema ou uma tag do Google no Tag Manager. No GA4, o sintoma costuma ser o evento page_view disparando duas vezes por carregamento de página, com visualizações e contagem de eventos infladas. Para confirmar, filtre por collect na aba Rede das ferramentas do navegador: duas requisições com o mesmo ID G- na mesma página indicam instalação dupla. No modo Visualizar do Tag Manager ou no DebugView, o mesmo evento aparece duas vezes. As causas mais comuns são o gtag.js no tema somado a uma tag do Google no contêiner ou o mesmo contêiner instalado duas vezes (Analytics Mania, eventos duplicados no GA4 ↗[18], consultado em 14/10/2026).
- Código apagado na atualização: gtag.js colado no header.php do tema principal some na atualização do tema; colado em arquivo do núcleo, some no core update, porque a documentação de atualização ↗[19] avisa que modificações nesses arquivos se perdem.
- Tag colada num bloco do editor: um bloco HTML personalizado no editor de blocos (Gutenberg) coloca o código só naquela página, e o resto do site fica sem medição.
- Segundo trecho do Tag Manager ausente: o tema não chama wp_body_open, e o trecho do <body> fica sem lugar para entrar.
- Dados ausentes após o banner de cookies: a ferramenta de consentimento bloqueia a tag até o aceite, e o relatório Tempo real mostra menos visitas do que o tráfego real. O modo de consentimento do Google ajusta o comportamento das tags do Google conforme a escolha do visitante e só cobre tags do Google: pixels de outras plataformas, como Meta e LinkedIn, precisam ser condicionados ao consentimento no próprio Tag Manager ou na ferramenta de consentimento (guia de consentimento da tag do Google ↗[20]).
- Funciona só no modo Visualizar: a versão do contêiner foi criada e ficou sem publicar.
- Formulário parou de mostrar a mensagem de sucesso depois do Tag Manager: o acionador Envio de formulário pode interferir em formulários enviados por JavaScript. Teste o formulário com o modo Visualizar ativo e, se for o caso, troque o acionador por um evento enviado pelo próprio formulário.
- Tag bloqueada pela política de segurança de conteúdo (CSP): o bloqueio acontece sem aviso visível na página. Os domínios do Google Tag Manager e do Google Analytics precisam constar nas diretivas script-src e connect-src, e o console do navegador mostra a violação.
- Tag Assistant não conecta: bloqueador de anúncios, ferramenta de consentimento, outras extensões do navegador ou política de segurança de conteúdo podem impedir a tag (Ajuda do Tag Manager, Tag Assistant ↗[21]).
Quando algo dá errado, volte um passo de cada vez: desative o plugin ou remova o código que acabou de entrar, confirme no código-fonte que sobrou uma única tag e repita a validação. Se a instalação no tema derrubou o site, restaure o backup ou desative o plugin de inserção de código pelo WP-CLI com wp plugin deactivate. No Tag Manager, abra Versões, clique na versão que funcionava e, em Ações, escolha Publicar. Se precisar ajustar algo antes, use Ações > Definir como a versão mais recente, que leva essa versão para o rascunho do espaço de trabalho; depois edite e publique de novo (Ajuda do Tag Manager, versões do contêiner ↗[22]).
Fazer sozinho ou contratar
Instalar o Site Kit e conectar o GA4 cabe a quem administra o site, sem código. Tag Manager com eventos personalizados, código em tema filho e medição de loja WooCommerce, que envolve eventos de compra, pedem desenvolvedor e alguém que conheça o GA4. Configurar os eventos de compra do WooCommerce no GA4 pelo Tag Manager costuma levar várias vezes o tempo de instalar só o contêiner. Quando a medição entra no planejamento de um projeto novo, as etapas de criar site em WordPress mostram onde ela se encaixa, e o conteúdo sobre quanto custa um site em WordPress ajuda a dimensionar o esforço. Para instalação, revisão ou correção de tags num site já no ar, a Studio Visual descreve o trabalho de especialista em WordPress na página de serviço.

