Testes e Diagnóstico

Verificar a Instalação do Pixel

Método 1: Extensão Metrito Pixel Helper (Recomendado)

A forma mais rápida de verificar é usando a extensão Metrito Pixel Helper para Chrome.

Instale a extensão (consulte o guia em Rastreamento via WhatsApp)
Acesse seu site
Procure o badge Metrito no canto inferior esquerdo da página

Se o badge aparecer, o pixel foi detectado. Clique no ícone da extensão para ver:

ID do contêiner
Dados do lead (após envio de formulário)
Domínio sendo rastreado

Método 2: Ferramentas de Desenvolvedor do Navegador

Abra as Ferramentas de Desenvolvedor (F12 ou Cmd+Shift+I) e verifique: Aba Console — Confirme que a função de rastreamento existe:

typeof window.mtrt; // deve retornar "function"

Aba Rede (Network) — Filtre por mtrt ou metrito e procure por:

Uma requisição para mtrttag.js (script de rastreamento sendo carregado)
Requisições POST para o seu subdomínio SST ou api.metrito.com quando eventos forem disparados

Aba Aplicativo (Application) > Armazenamento local (Local Storage) — Verifique as chaves do Metrito:

Chave	Indica
`metrito_lead_id` ou `mtrt_lead_id`	Um lead foi identificado
`metrito_lead_email`	E-mail do lead está salvo
`metrito_lead_phone`	Telefone do lead está salvo
`metrito_lead_name`	Nome do lead está salvo

Método 3: Verificar o Código-Fonte da Página

Veja o código-fonte da página (Ctrl+U) e procure por qualquer uma destas strings:

mtrt — namespace do pixel v3
mtrttag — script do pixel v3
MTC- — ID do contêiner

Testar Parâmetros UTM

Passo 1: Construa uma URL de Teste

Adicione parâmetros UTM a qualquer página do seu site:

https://seusite.com.br/landing?utm_source=teste&utm_campaign=Campanha Teste|999999&utm_medium=Conjunto Teste|888888&utm_content=Anuncio Teste|777777&utm_term=feed

Passo 2: Acesse a URL

Abra a URL de teste em uma janela privada/anônima do navegador para evitar dados em cache.

Passo 3: Verifique a Captura

Abra as Ferramentas de Desenvolvedor > Aplicativo > Cookies e procure por cookies do Metrito. O pixel armazena os UTMs em cookies para persistência na sessão.

Passo 4: Envie um Evento de Teste

Se houver um formulário na página, preencha e envie com dados de teste. Em seguida, verifique no painel do Metrito se o evento aparece com a atribuição UTM correta.

Testar a API de Eventos

Envie um evento de teste usando cURL:

curl -X POST https://api.metrito.com/v2/public/tracking/events \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sujaloja.com.br",
    "config": { "name": "EventoTeste" },
    "lead": {
      "name": "Usuário Teste",
      "email": "teste@exemplo.com"
    }
  }'

Resposta esperada:

{
  "success": true,
  "eventId": "1758388123_abc123def",
  "leadId": "lead_20250920_xyz789",
  "timestamp": 1758388123
}

Se receber 200 com "success": true, a API está recebendo eventos corretamente. Confirme no painel do Metrito se o evento aparece.

Testar Atribuição do Meta Ads

Crie uma campanha de teste no Meta Ads com os parâmetros UTM recomendados
Defina um orçamento diário pequeno
Clique no seu próprio anúncio (use uma janela privada)
Envie um formulário ou conclua uma compra no seu site
Verifique no painel do Metrito:
- O evento deve mostrar utm_source: facebook
- Nome e ID da campanha devem estar interpretados corretamente
- Detalhes do conjunto de anúncios e do criativo devem estar preenchidos

Verificar no Painel do Metrito

No painel, acesse:

Eventos — Verifique se os eventos aparecem em tempo real
Campanhas — Confirme que nomes de campanhas, conjuntos e anúncios estão exibindo corretamente
Leads — Confirme que os leads estão sendo criados com os dados de e-mail/telefone

Problemas Comuns

Pixel Não Detectado

Script não está carregando

Sintomas: Nenhum badge Metrito, nenhuma função mtrt no console, nenhuma requisição na aba Rede.Causas:

Tag de script não adicionada à página
Subdomínio SST incorreto no snippet
Política de Segurança de Conteúdo (CSP) bloqueando o script

Solução:

Veja o código-fonte da página e procure por mtrt
Se estiver ausente, adicione o snippet à tag <head>
Se estiver presente mas bloqueado, verifique os cabeçalhos CSP do site. Pode ser necessário adicionar seu subdomínio SST à diretiva script-src

ID do Contêiner incorreto

Sintomas: Script carrega, mas eventos não aparecem no seu painel do Metrito.Causa: O ID do Contêiner no snippet não corresponde ao seu contêiner.Solução: Acesse o Painel Metrito > Configurações > Contêiner de Rastreamento e copie o ID MTC-XXXXXXX correto.

Interferência de bloqueador de anúncios

Sintomas: Script carrega de forma intermitente ou não carrega para alguns usuários.Causa: Extensões de bloqueio de anúncios podem bloquear requisições para domínios de rastreamento conhecidos.Solução: Use o subdomínio dedicado (SST) com seu próprio domínio. Requisições para sst.seudominio.com.br não são bloqueadas por bloqueadores de anúncio e IOS pois aparecem como requisições de primeira parte.

Parâmetros UTM Ausentes

Parâmetros não aparecem na URL após clique no anúncio

Causa: Modelo UTM não configurado na plataforma de anúncios, ou configurado no nível errado.Solução:

Verifique se o modelo UTM está salvo no Gerenciador de Anúncios da Meta (Campanha > Editar > Rastreamento > Parâmetros de URL)
Certifique-se de que os parâmetros dinâmicos usam chaves duplas: {{campaign.id}} e não {campaign.id}
Visualize a URL do anúncio para confirmar que os parâmetros estão sendo adicionados

Parâmetros removidos por redirecionamento

Causa: Um encurtador de URL, serviço de redirecionamento ou CDN está removendo os parâmetros de query.Solução:

Teste colando a URL completa (com UTMs) diretamente no navegador
Verifique se suas regras de redirecionamento preservam os parâmetros de query
Se estiver usando um construtor de landing pages, confirme que ele não remove parâmetros desconhecidos

Nomes de campanha exibem como IDs

Causa: O padrão UTM usa apenas IDs, ou a configuração de posição dos campos está incorreta.Solução:

Verifique se os parâmetros de URL do Meta Ads incluem {{campaign.name}} antes de {{campaign.id}}
Confirme com o time Metrito se a configuração de posição do nome está correta para o seu contêiner

Eventos Não Chegam ao Metrito

API retorna erro 400

Causa: Campos obrigatórios ausentes.Solução: Certifique-se de que o payload inclui domain e config.name:

{
  "domain": "sujaloja.com.br",
  "config": { "name": "NomeDoEvento" }
}

Eventos não aparecem na Meta (config.facebook ausente)

Causa: config.facebook.name não incluído no payload do evento.Solução: Adicione o objeto facebook com um nome de evento padrão da Meta:

{
  "config": {
    "name": "MeuNomeInterno",
    "facebook": { "name": "Purchase" }
  }
}

Sem config.facebook, os eventos são rastreados no Metrito mas não encaminhados para a Meta CAPI.

Geolocalização mostra localização do servidor, não do usuário

Causa: Eventos enviados de um servidor backend usam o IP do servidor para geolocalização.Solução: Quando possível, envie eventos pelo frontend (navegador) para que a geolocalização seja detectada automaticamente pelo IP real do usuário.

Problemas de Identidade entre Canais

WhatsApp e sessões web não estão conectados

Causa: Parâmetro wa_session ausente nos links enviados pelo WhatsApp.Solução: Adicione ?wa_session=ID_UNICO_DA_CONVERSA a todos os links enviados do WhatsApp para o seu site. O pixel do Metrito captura esse parâmetro automaticamente e vincula à conversa do WhatsApp.

Leads duplicados para a mesma pessoa

Causa: Nenhum identificador compartilhado entre os canais. A unificação de identidade requer pelo menos um elo em comum (e-mail, telefone ou ID de sessão).Solução:

Colete e-mail ou telefone em ambos os canais
Use wa_session para conexão WhatsApp → web
O sistema unifica os perfis automaticamente quando identificadores compartilhados são detectados

Lista de Verificação

Use esta lista para verificar sua configuração sistematicamente:

Pixel instalado

Extensão Pixel Helper mostra badge verde no seu site. window.mtrt retorna "function" no console.

Eventos disparando

Aba Rede mostra requisições POST para o seu subdomínio SST quando ações ocorrem. Status da resposta é 200 ou 204.

UTMs capturados

Acesse seu site com parâmetros UTM. Verifique cookies/localStorage com os valores UTM armazenados.

Leads identificados

Envie um formulário com e-mail/telefone. Verifique no localStorage as chaves metrito_lead_id e metrito_lead_email.

Painel mostrando dados

Eventos aparecem no painel do Metrito com atribuição de campanha e dados de lead corretos.

Eventos Meta encaminhados

Eventos com config.facebook.name aparecem no Gerenciador de Eventos da Meta (pode levar 5-20 minutos).

Primeiros Passos

Rastreamento

​Verificar a Instalação do Pixel

​Método 1: Extensão Metrito Pixel Helper (Recomendado)

​Método 2: Ferramentas de Desenvolvedor do Navegador

​Método 3: Verificar o Código-Fonte da Página

​Testar Parâmetros UTM

​Passo 1: Construa uma URL de Teste

​Passo 2: Acesse a URL

​Passo 3: Verifique a Captura

​Passo 4: Envie um Evento de Teste

​Testar a API de Eventos

​Testar Atribuição do Meta Ads

​Verificar no Painel do Metrito

​Problemas Comuns

​Pixel Não Detectado

​Parâmetros UTM Ausentes

​Eventos Não Chegam ao Metrito

​Problemas de Identidade entre Canais

​Lista de Verificação