Rastreamento de eventos (GA4, Facebook e TikTok): como funciona e o que fazer se parar de registrar
Se a sua loja parou de registrar visitas, eventos ou vendas no Google Analytics 4 (GA4), Facebook (Meta) ou TikTok, mesmo sem alterações no código do tema, o problema costuma estar no método de envio de eventos ativo no painel ou nas credenciais da integração. Veja abaixo como funcionam os dois modos disponíveis na plataforma e como diagnosticar falhas de rastreamento.
Como funcionam os métodos de integração
Você define o modo de envio individualmente na configuração de cada ferramenta (GA4, Facebook ou TikTok) no painel administrativo da loja, pela opção "Habilitar eventos pelo server side tagging":
- Padrão (client-side): com a opção desabilitada, os scripts rodam no navegador do visitante. Quando o cliente acessa uma página ou conclui uma compra, o próprio navegador envia os dados para o Google, Meta ou TikTok.
- Server side tagging (via Zaraz): com a opção habilitada, o servidor da plataforma processa e envia os eventos diretamente para as ferramentas de análise, sem depender apenas do navegador do visitante.
Importante: a configuração é independente por ferramenta. Você pode usar o GA4 no modo server side tagging e manter o Pixel do Facebook no modo padrão, por exemplo.
Comparativo entre os métodos
Critério |
Padrão (client-side) |
Server side tagging (via Zaraz) |
|---|---|---|
Origem do envio |
Navegador do visitante |
Servidor da plataforma |
Configuração |
Opção "Habilitar eventos pelo server side tagging" desabilitada |
Opção "Habilitar eventos pelo server side tagging" habilitada |
Bloqueadores de anúncio (AdBlock) |
Impacto alto (podem bloquear o script) |
Impacto menor (envio feito pelo servidor) |
Velocidade da loja |
Carrega mais scripts no navegador |
Carrega menos scripts no navegador |
Principais falhas |
ID incorreto, script sobrescrito no tema, bloqueio do navegador ou consentimento de cookies |
ID ou token incorreto/vencido, opção alterada por engano ou integração desativada |
Envio de dados no modo server side
Com o server side tagging ativo, a plataforma envia os dados diretamente para as APIs oficiais de cada ferramenta:
- Google Analytics 4 (GA4): via Measurement Protocol.
- Facebook (Meta): via API de Conversões (CAPI).
- TikTok: via Events API.
Checklist de diagnóstico: por que os dados pararam?
Se os relatórios pararam de contabilizar acessos ou conversões, revise os pontos abaixo nesta ordem:
1. Verificações gerais (ambos os métodos)
- ID de medição ou Pixel incorreto: confirme se o ID cadastrado no painel da loja é idêntico ao do Google Analytics, Gerenciador de Eventos da Meta ou TikTok Ads Manager.
- Fluxo de dados desativado no GA4: no Google Analytics, acesse Administrador > Fluxos de dados e veja se o fluxo da Web está ativo.
- Banner de consentimento de cookies (LGPD): se a ferramenta de privacidade bloqueia scripts antes do aceite, os eventos não disparam quando o visitante recusa ou ignora o aviso.
- Propriedade ou conta errada: verifique se você está olhando a propriedade ou conta de anúncios correta na ferramenta.
2. Falhas no método Padrão (client-side)
- Alteração no tema ou código personalizado: edições no HTML/JavaScript da loja podem remover ou gerar conflito com os scripts nativos.
- Bloqueadores de anúncio e navegadores: extensões como AdBlock e navegadores com bloqueio de rastreadores (como Safari e Brave) impedem o disparo pelo navegador.
3. Falhas no Server side tagging
- Opção alterada por engano: a opção "Habilitar eventos pelo server side tagging" foi marcada ou desmarcada sem as credenciais necessárias configuradas.
- Token de acesso vencido ou inválido (Facebook e TikTok): os tokens da API de Conversões da Meta e da Events API do TikTok podem expirar ou ser revogados se a senha ou as permissões da conta mudarem.
- Integração desativada: confirme se a chave geral da integração segue ativa no painel da loja.
4. Boas práticas sobre troca de método e duplicidade
- Troca de método: ao marcar ou desmarcar a opção "Habilitar eventos pelo server side tagging", o envio muda entre navegador e servidor. Faça um teste de navegação ou compra após alterar a configuração para confirmar o recebimento dos dados.
- Eventos duplicados: se você adicionou o código do GA4 ou do Pixel manualmente no tema (ou via Google Tag Manager) junto com a integração nativa da loja, os eventos serão contados em dobro. Mantenha apenas uma instalação ativa.
Como identificar o método ativo e testar os eventos
- No painel administrativo da loja, acesse Configurações > Integrações e abra a configuração do GA4, Facebook ou TikTok.
- Verifique a opção "Habilitar eventos pelo server side tagging":
- Marcada: a loja usa Server side tagging (via Zaraz).
- Desmarcada: a loja usa o método Padrão (client-side).
- Abra sua loja em uma aba anônima do navegador, acesse um produto e adicione-o ao carrinho.
- Confira o recebimento em tempo real na ferramenta correspondente:
- GA4: acesse Relatórios > Tempo real e veja se a visita e os eventos (page_view, view_item, add_to_cart) aparecem em até 1 minuto.
- Facebook (Meta): acesse Gerenciador de Eventos > Eventos de teste e confira se os eventos chegam como Navegador ou Servidor.
- TikTok: acesse TikTok Events Manager > Eventos de teste para confirmar o recebimento.
Quando falar com o suporte
Se você já revisou os IDs, conferiu a opção "Habilitar eventos pelo server side tagging" e os eventos seguem sem aparecer nos testes, abra um chamado com nosso suporte informando:
- Domínio da loja (ex.: www.sualoja.com.br);
- Ferramenta afetada (GA4, Facebook/Meta ou TikTok);
- Método ativo no painel (Padrão ou Server side tagging);
- ID da métrica ou do Pixel cadastrado no painel;
- Eventos afetados (todos os acessos ou específicos, como purchase) e a data aproximada do início da falha;
- Prints da tela de configuração no painel da loja e da tela de Tempo real ou Eventos de teste da ferramenta.