> ## 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.

# Pixels

> Cadastre os pixels da Meta que vão receber as conversões do Metrito via API de Conversões (CAPI).

## Para que servem os pixels

O Metrito rastreia tudo dentro do container, mas para **otimizar suas campanhas** ele precisa devolver as conversões para a Meta. Quem recebe essas conversões é o **pixel**. Sem um pixel cadastrado, os eventos ficam só no Metrito e não chegam ao **Gerenciador de Eventos** da Meta.

O envio é feito pela **API de Conversões (CAPI)** — server-side — o que aumenta a qualidade e a cobertura dos dados em relação ao pixel só no navegador.

## Cadastrar um pixel

Na seção **Pixels**, clique em **Cadastrar novo Pixel**. No modal **Configurações do Pixel**, preencha:

| Campo                      | O que é                                                     |
| -------------------------- | ----------------------------------------------------------- |
| **ID do Pixel**            | O ID do pixel no Gerenciador de Eventos da Meta             |
| **Nome do Pixel**          | Um nome para você identificar (ex.: "Pixel Loja Principal") |
| **Tipo do Pixel**          | **Web (Website)** ou **WhatsApp Business** (veja abaixo)    |
| **Token de Acesso da API** | O token de CAPI gerado no Gerenciador de Eventos            |

Depois de preencher, use **Validar Pixel** para confirmar que o ID e o token estão corretos antes de salvar.

<Tip>
  O **Token de Acesso da API** é gerado no Gerenciador de Eventos da Meta, nas configurações do pixel → **API de Conversões** → **Gerar token de acesso**. É ele que autoriza o Metrito a enviar eventos em nome do seu pixel.
</Tip>

## Web ou WhatsApp Business: qual escolher

Essa é a parte mais importante — e a que mais gera confusão.

<CardGroup cols={2}>
  <Card title="Web (Website)" icon="globe">
    O pixel comum, que todo mundo usa. É o **padrão** e cobre a grande maioria dos casos: site, landing page, checkout e **links de redirect** (inclusive Smart WhatsApp).
  </Card>

  <Card title="WhatsApp Business" icon="whatsapp">
    Um pixel de **mensagem**, usado **apenas** quando suas campanhas são **100% nativas** de mensagem (direto para o WhatsApp, sem link de redirect).
  </Card>
</CardGroup>

<Warning>
  Um pixel de mensagem **precisa ter sido criado como pixel de mensagem** lá no Gerenciador de Eventos, desde o início. Você **não** pode pegar um pixel Web e simplesmente marcá-lo como **WhatsApp Business** aqui. Se você não criou um pixel de mensagem na Meta, **não** selecione **WhatsApp Business**.
</Warning>

Na dúvida, use **Web (Website)**. Regra prática:

* Usa **link de redirect** (Smart WhatsApp ou Smart Web)? → **Web (Website)**.
* Campanhas **nativas de mensagem** com pixel de mensagem criado na Meta? → **WhatsApp Business**.

## Modo de teste

Em **Configurações de Teste**, você pode ativar o **Modo de Teste** e informar um **Código de Teste**.

Com o modo de teste ligado, os eventos são enviados para a aba de **Testar eventos** do Gerenciador de Eventos — onde você vê cada evento chegando e sendo **deduplicado** quase em tempo real. Esses eventos **não contam como métricas de produção**.

<Warning>
  Enquanto o **Modo de Teste** estiver ligado, o pixel **para de enviar eventos reais** e manda tudo só para o ambiente de teste. **Desligue assim que terminar de testar**, ou você fica sem rastreamento de produção.
</Warning>

Fluxo recomendado:

<Steps>
  <Step title="Pegue o código de teste na Meta">
    No Gerenciador de Eventos, abra o pixel → aba **Testar eventos** e copie o código exibido.
  </Step>

  <Step title="Ative o Modo de Teste no Metrito">
    Cole o código em **Código de Teste** e ligue o **Modo de Teste**.
  </Step>

  <Step title="Dispare eventos e confira">
    Navegue no site, faça uma compra de teste ou dispare um evento manual e veja-os chegarem na aba **Testar eventos**.
  </Step>

  <Step title="Desligue o Modo de Teste">
    Terminou? Desligue para voltar a enviar eventos de produção.
  </Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Eventos" icon="arrow-pointer" href="/tracking/eventos">
    Defina quais ações são enviadas como conversão para os pixels.
  </Card>

  <Card title="Sessões e leads" icon="list" href="/tracking/sessoes">
    Audite o payload exato enviado à Meta e a resposta da CAPI.
  </Card>
</CardGroup>