Google Analytics no WordPress: Guia Completo de Instalação e Configuração
Instalar o GA4 no WordPress pode ser feito de várias formas: plugin, código manual ou Google Tag Manager. Cada método tem vantagens diferentes. Neste guia, você aprende todos os métodos, configurações essenciais, tracking de eventos e e-commerce.
Pré-requisito: criar a propriedade GA4
Antes de instalar no WordPress, crie sua propriedade no Google Analytics:
- Acesse
analytics.google.com - Clique em Admin (engrenagem)
- Clique em + Criar propriedade
- Preencha: nome do site, fuso horário (Brasília), moeda (BRL)
- Selecione o tipo de plataforma: Web
- Insira a URL do seu site
- Copie o Measurement ID (formato: G-XXXXXXXXXX) — você vai precisar dele
Também copie o código do Google tag (gtag.js) que aparece na tela de configuração. Será necessário para instalação manual.
Método 1: Plugin (mais fácil)
Plugins são a forma mais simples de instalar o GA4. Recomendados para quem não quer mexer em código.
Site Kit by Google (recomendado)
Plugin oficial do Google que integra GA4, Search Console, AdSense e PageSpeed Insights em um dashboard no próprio WordPress.
Instalação:
- No WordPress, vá em Plugins > Adicionar novo
- Busque por "Site Kit by Google"
- Instale e ative
- Siga o wizard de configuração — conecte sua conta Google
- Selecione a propriedade GA4 existente (ou crie uma nova)
- O plugin adiciona o código de rastreamento automaticamente
Vantagens:
- Instalação guiada (sem código)
- Dashboard com dados do GA4 dentro do WordPress
- Integra múltiplos serviços Google
- Atualizações automáticas do código de rastreamento
Desvantagem: plugin pesado (adiciona JavaScript ao admin). Se você só quer o código de rastreamento, é overkill.
MonsterInsights
Plugin de analytics mais popular do WordPress (3M+ instalações). Interface amigável com relatórios no dashboard.
- Versão Lite (gratuita): instalação do GA4, relatórios básicos no dashboard
- Versão Pro ($99/ano): tracking de e-commerce, formulários, dimensões customizadas, relatórios avançados
Quando usar: se quer relatórios do GA4 dentro do WordPress sem acessar o painel do Google Analytics. A versão Pro é útil para e-commerce com WooCommerce.
GA Google Analytics (leve)
Plugin minimalista de Jeff Starr. Faz apenas uma coisa: adiciona o código de rastreamento do GA4 ao site. Sem dashboard, sem bloat.
- Instale e ative
- Cole o Measurement ID (G-XXXXXXXXXX) nas configurações
- Pronto
Quando usar: se quer a forma mais leve de instalar GA4 via plugin. Zero overhead.
Método 2: Instalação manual (sem plugin)
Para quem prefere não adicionar mais um plugin. O código é inserido diretamente no tema.
Via functions.php
Adicione ao arquivo functions.php do seu tema filho (child theme):
function add_gtag_script() {
?>
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-XXXXXXXXXX');
</script>
<?php
}
add_action('wp_head', 'add_gtag_script');
Substitua G-XXXXXXXXXX pelo seu Measurement ID.
Via header.php
Alternativa: cole o código gtag.js diretamente no header.php antes do </head>. Menos elegante mas funciona. Use apenas em tema filho para não perder na atualização do tema.
Via plugin de snippets
Se não quer editar arquivos PHP, use um plugin como WPCode (anteriormente Insert Headers and Footers):
- Instale WPCode
- Cole o código gtag.js na seção "Header"
- Salve
Vantagem: não precisa mexer em arquivos do tema e sobrevive a atualizações.
Método 3: Google Tag Manager (mais flexível)
O GTM (Google Tag Manager) é um container de tags que permite gerenciar GA4 e dezenas de outras tags (Facebook Pixel, Clarity, Hotjar, etc.) sem mexer no código do site.
Por que usar GTM
- Gerencia múltiplas tags em um lugar (GA4, Pixel, Clarity, etc.)
- Adiciona eventos sem mexer no código
- Ambientes de staging/produção (evita poluir dados)
- Controle de consentimento centralizado
- Histórico de versões (rollback se algo quebrar)
Instalação do GTM no WordPress
- Crie um container GTM: acesse
tagmanager.google.com, crie conta e container web - Instale o código GTM: o GTM gera dois snippets — um para o
<head>e um para o<body>. Instale via plugin (WPCode ou Site Kit) ou diretamente no tema - Adicione o GA4 como tag no GTM:
- No GTM, vá em Tags > Nova
- Tipo: Google Analytics: GA4 Configuration
- Measurement ID:
G-XXXXXXXXXX - Trigger: All Pages
- Salve e publique
Adicionando Clarity via GTM
Aproveite o GTM para instalar o Microsoft Clarity junto com o GA4:
- No GTM, crie uma nova tag: Custom HTML
- Cole o código de instalação do Clarity
- Trigger: All Pages
- Publique
Agora você tem GA4 + Clarity gerenciados pelo mesmo container, sem nenhum código no WordPress.
Configuração essencial do GA4
Após instalar o código, configure o GA4 corretamente:
Eventos automáticos (Enhanced Measurement)
O GA4 rastreia automaticamente vários eventos sem configuração adicional. Verifique se estão ativados em Admin > Data Streams > seu stream > Enhanced Measurement:
- Page views — cada visualização de página
- Scrolls — quando o usuário rola 90% da página
- Outbound clicks — cliques em links para outros domínios
- Site search — buscas internas (detecta automaticamente parâmetros ?s= ou ?q=)
- Video engagement — play, progresso e conclusão de vídeos YouTube embedados
- File downloads — cliques em links de PDF, DOC, ZIP etc.
- Form interactions — start e submit de formulários
Conversões (Key Events)
No GA4, conversões são chamadas de "Key Events". Configure as ações mais importantes do seu site:
Para blog/conteúdo:
- Inscrição na newsletter
- Download de material
- Scroll até 75% em artigos longos
Para e-commerce (WooCommerce):
- add_to_cart
- begin_checkout
- purchase
Para geração de leads:
- Envio de formulário de contato
- Clique em "Solicitar orçamento"
- Download de proposta
Para marcar um evento como conversão: Admin > Events, encontre o evento e ative o toggle "Mark as key event".
Filtros e exclusões
- Excluir tráfego interno: em Admin > Data Streams > Configure tag settings > Define internal traffic, adicione o IP do escritório/casa
- Excluir referrals: em Admin > Data Streams > Configure tag settings > List unwanted referrals, adicione domínios de gateway de pagamento (pagseguro, stripe.com) para que compras não apareçam como tráfego de referência
- Cross-domain tracking: se tem mais de um domínio (ex: blog.seusite.com + app.seusite.com), configure cross-domain em Configure tag settings
E-commerce tracking com WooCommerce
Para lojas WooCommerce, o GA4 pode rastrear todo o funil de compra.
Opção 1: MonsterInsights Pro
A forma mais fácil. O plugin detecta WooCommerce automaticamente e configura todos os eventos de e-commerce:
view_item— visualização de produtoadd_to_cart— adição ao carrinhobegin_checkout— início do checkoutpurchase— compra concluída (com receita, produtos, etc.)
Opção 2: GTM + dataLayer
Para controle total, implemente o dataLayer manualmente ou com o plugin GTM4WP:
- Instale o plugin GTM4WP (Google Tag Manager for WordPress)
- Nas configurações, ative "WooCommerce integration"
- O plugin popula o dataLayer com dados de e-commerce automaticamente
- No GTM, crie tags GA4 Event para cada etapa do funil
Este método é mais trabalhoso mas dá controle total e não depende de plugins de analytics pesados.
Eventos personalizados
Além dos eventos automáticos, configure eventos para ações específicas do seu site:
Via GTM (recomendado)
Exemplo: rastrear cliques em um botão de CTA:
- No GTM, crie um trigger: Click > All Elements
- Condição: Click Classes contém "btn-cta" (ou o seletor do seu botão)
- Crie uma tag GA4 Event com nome "cta_click"
- Adicione parâmetros: cta_text (texto do botão), cta_location (URL da página)
- Teste no modo Preview e publique
Via gtag.js (código direto)
// Rastrear clique em CTA
document.querySelector('.btn-cta').addEventListener('click', function() {
gtag('event', 'cta_click', {
'event_category': 'engagement',
'event_label': this.textContent,
'page_location': window.location.href
});
});
Verificando se funciona
Após a instalação, confirme que o GA4 está rastreando corretamente:
1. Relatório em tempo real
No GA4, vá em Reports > Realtime. Abra seu site em outra aba. Você deve aparecer como visitante ativo em poucos segundos.
2. DebugView
Em Admin > DebugView, veja eventos em tempo real com detalhes. Para ativar, instale a extensão Google Analytics Debugger no Chrome ou adicione debug_mode: true na configuração do gtag.
3. Tag Assistant
Extensão Chrome Google Tag Assistant verifica se as tags estão instaladas corretamente e mostra erros.
4. Chrome DevTools
Na aba Network, filtre por "google-analytics" ou "gtag". Você deve ver requisições sendo enviadas a cada pageview e evento.
GA4 + Clarity: a combinação ideal
O GA4 mostra o quê (quantas visitas, de onde, quanto converteu). O Microsoft Clarity mostra o porquê (como interagiram, onde ficaram frustrados, o que ignoraram).
Quando integrados, você pode:
- Ver dados do Clarity dentro do GA4 (integração nativa)
- Clicar em sessões do GA4 e ver a gravação correspondente no Clarity
- Filtrar gravações do Clarity por métricas do GA4 (ex: sessões que converteram vs que abandonaram)
Para ativar a integração: no dashboard do Clarity, vá em Settings > Google Analytics integration e conecte sua propriedade GA4.
O ClarityInsights leva essa integração mais longe, analisando automaticamente os dados do Clarity e gerando relatórios semanais com insights de UX que complementam os dados quantitativos do GA4.
Erros comuns ao instalar GA4 no WordPress
- Código duplicado — instalar via plugin E manualmente. O GA4 conta tudo duas vezes. Use apenas um método
- Não excluir tráfego admin — suas próprias visitas ao site inflam os dados. Exclua seu IP
- Não configurar conversões — sem conversões definidas, o GA4 é apenas um contador de visitas. Configure pelo menos 3-5 conversões
- Ignorar Enhanced Measurement — muitos não sabem que scroll, busca interna e downloads já são rastreados automaticamente. Basta ativar
- Não testar após atualização de tema — se instalou manualmente no header.php (sem child theme), atualizações do tema removem o código
- Plugin de cache servindo versão sem código — após instalar GA4, limpe o cache do plugin de cache e do CDN
Quer relatórios automáticos do Clarity?
ClarityInsights analisa seus dados e envia um relatório AI com recomendações UX.
Obtenha seu relatório grátis