> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Testes e diagnóstico

> Confirme que o rastreamento está funcionando e resolva os problemas mais comuns.

## 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](/tracking/web-setup), 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](/tracking/overview). 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](/tracking/sessoes): 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

<AccordionGroup>
  <Accordion title="O script não está carregando">
    **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`.
  </Accordion>

  <Accordion title="É uma loja Shopify">
    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.
  </Accordion>

  <Accordion title="Bloqueador de anúncios / Safari / iOS interferindo">
    **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](/tracking/dominios) — requisições para `sst.seudominio.com` são de primeira parte e não são bloqueadas.
  </Accordion>
</AccordionGroup>

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

<Accordion title="O rastreamento 'para' em páginas com player de vídeo ou checkout 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](/tracking/avancado), troque o **Parâmetro de Identificação de Visitante** (ex.: para `sck`) ou alinhe-o ao que a Hotmart envia (`xcod`).
</Accordion>

### UTMs não aparecem

<AccordionGroup>
  <Accordion title="Os parâmetros somem após o clique no anúncio">
    **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](/tracking/utm-configuration).
  </Accordion>

  <Accordion title="Os parâmetros são removidos por um redirecionamento">
    **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**.
  </Accordion>
</AccordionGroup>

### Eventos não chegam à Meta

<AccordionGroup>
  <Accordion title="A compra (Purchase) não dispara">
    **Causa:** o rastreamento do checkout está desligado.

    **Solução:** ative o interruptor do checkout na seção de [Checkouts](/tracking/checkouts) ou na coluna **Tracking** das [Integrações](/integracoes/overview).
  </Accordion>

  <Accordion title="Os eventos aparecem só em 'Testar eventos' e não como métrica">
    **Causa:** o **Modo de Teste** do pixel ficou ligado.

    **Solução:** desligue o Modo de Teste em [Pixels](/tracking/pixels) para voltar a enviar eventos de produção.
  </Accordion>

  <Accordion title="Nenhum pixel cadastrado">
    **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](/tracking/pixels).
  </Accordion>
</AccordionGroup>

### WhatsApp sem atribuição

<AccordionGroup>
  <Accordion title="Conversas do WhatsApp não contam nas Campanhas">
    **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](/tracking/whatsapp).
  </Accordion>

  <Accordion title="O número não está enviando dados">
    **Causa:** a instância do WhatsApp não está vinculada ao container.

    **Solução:** ative a instância na seção [WhatsApp](/tracking/whatsapp) (card **Conectar WhatsApp**).
  </Accordion>
</AccordionGroup>

## Lista de verificação

<Steps>
  <Step title="Script instalado">Selo **Verificado** verde na tela de instalação, ou `window.metrito` retorna `"function"` no console.</Step>
  <Step title="Recebendo dados">A Visão Geral mostra **Recebendo dados** nas últimas 24h para o canal Web (e WhatsApp, se usar).</Step>
  <Step title="UTMs capturados">Acesse o site com UTMs de teste e confira a atribuição numa sessão.</Step>
  <Step title="Leads identificados">Envie um formulário com e-mail/telefone e veja o lead na tela de Sessões.</Step>
  <Step title="Pixel recebendo">Eventos com pixel cadastrado aparecem no Gerenciador de Eventos da Meta (pode levar alguns minutos).</Step>
  <Step title="Checkout ativo">O interruptor do checkout está ligado e o `Purchase` dispara nas compras.</Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Sessões e leads" icon="list" href="/tracking/sessoes">
    Audite o payload e a resposta da Meta evento por evento.
  </Card>

  <Card title="API de Eventos" icon="terminal" href="/tracking/events-api">
    Envie eventos pelo servidor a partir de qualquer sistema.
  </Card>
</CardGroup>
