Skip to main content

​
Como saber se está funcionando

Há quatro formas de confirmar que o tracking está ativo — da mais rápida à mais técnica.

​
1. Verificação de instalação (na própria tela)

Na tela de Instalação no site, depois de publicar o site, use o botão de verificação de instalação. O Metrito acessa seu site e, se encontrar o script, o card fica verde com o selo Verificado e mostra em quantas páginas o script foi detectado.

​
2. Status de Recebimento (últimas 24h)

Abra a Visão Geral. O card Status de Recebimento (últimas 24h) mostra, por canal:
  • Recebendo dados (verde) — chegaram eventos nas últimas 24 horas.
  • Sem dados recentes (vermelho) — nada nas últimas 24 horas; vale investigar.
Se aparecer Recebendo dados no canal Web, a instalação está ok. O mesmo vale para o canal WhatsApp.

​
3. Extensão Metrito Pixel Helper

A extensão Metrito Pixel Helper (Chrome) confirma o rastreamento em tempo real. Com ela instalada, acesse uma página com o pixel e veja:
  • se o script foi detectado e qual o ID do container (MTC-XXXXXXX);
  • os dados do lead salvos no navegador (ID, nome, e-mail, telefone);
  • os eventos disparando, conforme acontecem.
O link de instalação da extensão está no botão Como verificar a instalação, na tela de instalação do site.

​
4. Ferramentas de desenvolvedor

Abra o DevTools (F12 ou Cmd+Shift+I):
  • Console — typeof window.metrito deve retornar "function".
  • Rede (Network) — filtre por mtrt ou metrito. Você deve ver o mtrttag.js carregando e requisições POST para o seu subdomínio sst. (ou para a API do Metrito) quando eventos disparam.

​
Auditar um evento específico

Para ir além do “chegou ou não”, use a tela de Sessões e leads: clique em um evento e veja o payload exato enviado à Meta e a resposta da CAPI. É o jeito mais preciso de entender por que um evento não casou.

​
Problemas comuns

​
O script não é detectado

Sintomas: sem selo Verificado, window.metrito não existe, nenhuma requisição na aba Rede.Possíveis causas e soluções:
  • O script não foi colado na <head> de todas as páginas → confira o código-fonte (Ctrl+U) e procure por mtrt/MTC-.
  • Uma CSP (Content Security Policy) está bloqueando → libere o domínio do script (e o seu sst. se usar bypass) na diretiva script-src.
A Shopify trata scripts de terceiros de forma diferente e a instalação manual no tema pode não funcionar. Para Shopify, use o caminho de integração dedicado — fale com o time do Metrito.
Sintomas: o script carrega para uns visitantes e não para outros.Solução: ative o bypass rodando o tracking no seu próprio domínio. Veja Domínios e bypass — requisições para sst.seudominio.com são de primeira parte e não são bloqueadas.

​
Conflito de parâmetro (VTurb, Panda, Hotmart)

Causa: players como VTurb/Panda usam src, e a Hotmart usa src/xcod — o mesmo parâmetro que o Metrito usa por padrão para identificar o visitante.Solução: em Avançado, troque o Parâmetro de Identificação de Visitante (ex.: para sck) ou alinhe-o ao que a Hotmart envia (xcod).

​
UTMs não aparecem

Causa: o template de UTM não está configurado na plataforma de anúncios, ou está no nível errado.Solução: confira se o template está salvo no nível da campanha no Gerenciador de Anúncios, e se usa chaves duplas ({{campaign.id}}, não {campaign.id}). Veja Parâmetros e UTMs.
Causa: um encurtador, CDN ou builder de landing page está descartando a query string.Solução: teste colando a URL completa no navegador e garanta que suas regras de redirect preservam os parâmetros.

​
Eventos não chegam à Meta

Causa: o rastreamento do checkout está desligado.Solução: ative o interruptor do checkout na seção de Checkouts ou na coluna Tracking das Integrações.
Causa: o Modo de Teste do pixel ficou ligado.Solução: desligue o Modo de Teste em Pixels para voltar a enviar eventos de produção.
Causa: sem pixel, os eventos ficam só no Metrito.Solução: cadastre um pixel com ID e token válidos e use Validar Pixel. Veja Pixels.

​
WhatsApp sem atribuição

Causa: a conversa chegou sem UTM — por perda de CTWA (o cliente desativou o rastreamento no aparelho) ou porque a mensagem padrão do link foi apagada.Solução: prefira o link Smart WhatsApp, que carrega os UTMs na mensagem padrão. Veja Rastreamento no WhatsApp.
Causa: a instância do WhatsApp não está vinculada ao container.Solução: ative a instância na seção WhatsApp (card Conectar WhatsApp).

​
Lista de verificação

1

Script instalado

Selo Verificado verde na tela de instalação, ou window.metrito retorna "function" no console.
2

Recebendo dados

A Visão Geral mostra Recebendo dados nas últimas 24h para o canal Web (e WhatsApp, se usar).
3

UTMs capturados

Acesse o site com UTMs de teste e confira a atribuição numa sessão.
4

Leads identificados

Envie um formulário com e-mail/telefone e veja o lead na tela de Sessões.
5

Pixel recebendo

Eventos com pixel cadastrado aparecem no Gerenciador de Eventos da Meta (pode levar alguns minutos).
6

Checkout ativo

O interruptor do checkout está ligado e o Purchase dispara nas compras.

​
Próximos passos

Sessões e leads

Audite o payload e a resposta da Meta evento por evento.

API de Eventos

Envie eventos pelo servidor a partir de qualquer sistema.