Como instalar a tag do Google no WordPress: três caminhos e como validar

Escrito e revisado por pessoas

Revisado por Amanda Noronha, Head de SEO

Compartilhar:

Como instalar a tag do Google no WordPress: três caminhos e como validar

RESPOSTA RÁPIDA

Para instalar a tag do Google no WordPress, escolha um de três caminhos: o plugin Site Kit, o Google Tag Manager ou o código gtag.js inserido no tema. Os três funcionam bem desde que a tag fique instalada uma única vez por página, porque dois métodos ativos ao mesmo tempo duplicam a medição.

Pontos principais

  • Site Kit resolve a maioria dos sites que só precisam de Google Analytics 4 e Search Console, sem editar código.
  • Google Tag Manager compensa quando o site vai receber várias tags e eventos, mantidos por quem cuida do marketing.
  • Código no tema só em tema filho ou plugin próprio, para a atualização do tema não apagar a instalação.
  • Google Ads e Google Analytics 4 podem compartilhar a mesma tag do Google, como destinos diferentes.
O que é WordPress: como funciona, para que serve e quando usar

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

  1. 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-.
  2. 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.
  3. 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.
  4. 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]).

  1. Em Plugins > Adicionar novo, procure por Site Kit by Google, instale e ative. Pelo WP-CLI, o equivalente é wp plugin install google-site-kit –activate.
  2. Rode a configuração inicial e entre com a conta Google que tem acesso às propriedades.
  3. 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.

  1. Crie a conta e o contêiner da web em tagmanager.google.com.
  2. 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]).
  3. 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]).
  4. Clique em Visualizar (Preview), informe a URL do site e conecte o Tag Assistant para ver se a tag dispara.
  5. 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 do functions.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

, sem aviso no log de depuração. Troque o ID de exemplo pelo ID de métricas do seu fluxo de dados.

“`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.”

joao pedro tiberio 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.

Referências

As fontes citadas neste artigo, na ordem em que aparecem no texto.

  1. 1
    documentação da tag do Google

    Google for Developers · Dados consultados em 25 de setembro de 2026

  2. 2
    Ajuda do Tag Manager

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  1. 3
    Ajuda do Analytics

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  2. 4
    página do plugin

    WordPress.org · Dados consultados em 25 de setembro de 2026

  3. 5
    documentação do Site Kit, Analytics

    sitekit.withgoogle.com · Dados consultados em 25 de setembro de 2026

  4. 6
    documentação do Site Kit sobre código posicionado

    sitekit.withgoogle.com · Dados consultados em 25 de setembro de 2026

  5. 7
    Ajuda do Tag Manager, instalar contêiner

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  6. 8
    referência do wp_body_open

    WordPress Developer Resources · Dados consultados em 25 de setembro de 2026

  7. 9
    Ajuda do Tag Manager, tag do Google

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  8. 10
    Ajuda do Tag Manager, verificar e publicar

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  9. 11
    documentação do Site Kit, Tag Manager

    sitekit.withgoogle.com · Dados consultados em 25 de setembro de 2026

  10. 12
  11. 13
    documentação de temas filhos

    WordPress Developer Resources · Dados consultados em 25 de setembro de 2026

  12. 14
    Ajuda do Google Ads

    Ajuda do Google · Dados consultados em 25 de setembro de 2026

  13. 15
  14. 16
    Ajuda do Analytics, DebugView

    Ajuda do Google · Dados consultados em 29 de setembro de 2026

  15. 17
    Ajuda do Search Console

    Ajuda do Google · Dados consultados em 29 de setembro de 2026

  16. 18
  17. 19
    documentação de atualização

    WordPress.org · Dados consultados em 25 de setembro de 2026

  18. 20
  19. 21
    Ajuda do Tag Manager, Tag Assistant

    Ajuda do Google · Dados consultados em 29 de setembro de 2026

  20. 22

Especialista em WordPress

Especialistas em WordPress na Studio Visual

Desenvolvimento, manutenção e evolução de sites WordPress para empresas, com o mesmo time do projeto ao suporte.

Compartilhar:

Levar para a IA:

Vamos bater um papo sobre suas necessidades?

Queremos conhecer você e sua empresa!

Compartilhe conosco os desafios digitais e as necessidades técnicas que você enfrenta. Estamos aqui para ajudar, permitindo que você se concentre no que realmente importa: os resultados.