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

# Meta Ads

> Envie suas conversões para o pixel da Meta pelo navegador e pela API de Conversões, com deduplicação automática.

No fim deste guia, cada evento que você escolher vai para a Meta **duas vezes**: pelo pixel no navegador e pela **API de Conversões** no servidor, com o mesmo `event_id`. A Meta junta as duas e conta **uma** conversão, com a maior qualidade de dados possível.

> [!NOTE]
>
> **Tempo:** cerca de 10 minutos. **Você vai precisar de:** acesso de administrador ao pixel (conjunto de dados) no Gerenciador de Eventos da Meta.

**1. Conecte a conta de anúncios**

Em **Integrações**, clique em **Adicionar Integração**, escolha **Meta Ads** e autorize. Isso traz gasto e campanhas para a Metrito. Veja [Contas de anúncio](https://docs.metrito.com/integracoes/contas-de-anuncio.md).

> [!NOTE]
>
> A conexão da conta serve para os **relatórios**. O envio de conversões usa o **token do pixel** (próximo passo), então os dois funcionam de forma independente.

**2. Gere o token da API de Conversões na Meta**

1. Abra o [Gerenciador de Eventos](https://business.facebook.com/events_manager2) e clique no pixel (conjunto de dados) que vai receber as conversões.
2. Copie a **Identificação do conjunto de dados**: é o **ID do Pixel**.
3. Vá na aba **Configurações**, desça até **Configurar integração direta**, deixe marcado **Configurar com a Dataset Quality API** e clique em **Gerar token de acesso**.
4. Copie o token. Ele aparece uma vez só.

![Seção Configurar integração direta no Gerenciador de Eventos da Meta, com o botão Gerar token de acesso](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/meta-gerar-token.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=8d7491055dc63b4387f07c286c4ddf45)

Gerenciador de Eventos > o pixel > Configurações > Configurar integração direta.

> [!TIP]
>
> Com a **Dataset Quality API** marcada, a Metrito consegue mostrar a nota de qualidade de cada evento direto no card do destino.

**3. Crie o destino na Metrito**

Em **Rastreamento** > **Destinos/Pixels**, clique em **Cadastrar novo destino**, escolha **Meta Ads** e clique em **Próximo**.

![Assistente Novo destino de evento, passo Fonte, com Meta Ads selecionado](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/destino-fonte.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=99543fc30c1ce0d7627cff63d7dbc925)

Preencha:

| Campo | O que colocar |
| - | - |
| **ID do Pixel** | A identificação copiada no passo anterior. |
| **Nome do Pixel** | Um nome para você reconhecer, ex.: "Pixel Loja". |
| **Tipo do Pixel** | **Site** em quase todos os casos. Veja o aviso abaixo. |
| **Token de Acesso da API** | O token gerado no passo anterior. |

Clique em **Validar Pixel**. Quando aparecer **Pixel validado com sucesso!**, avance para **Revisar** e clique em **Criar destino**.

![Passo Configurar do destino Meta com ID do Pixel, Nome do Pixel, Tipo do Pixel e Token de Acesso da API](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/destino-meta-configurar.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=8a104b265e505f751f745bfa709f61ad)

> [!WARNING]
>
> Escolha **WhatsApp** **só** se o pixel foi criado na Meta como pixel de **mensagem** e suas campanhas são 100% de clique para o WhatsApp, sem link de redirect. Pixel de site marcado como WhatsApp não funciona. Na dúvida, **Site**.

**4. Ligue a Meta nos eventos**

Em **Rastreamento** > **Eventos**, clique no lápis do evento (ou em **Novo evento**). No passo **Evento**, ligue o card **Meta Ads** e escolha o nome:

* **Tipo do evento:** **Website** para eventos de site e checkout. **Business Messaging** só com pixel de mensagem.
* **Nome do evento:** um evento padrão da Meta (`Purchase`, `Lead`, `InitiateCheckout`, `Contact`). Evento padrão é o que a Meta usa para otimizar.

![Card Meta Ads ligado no evento, com Tipo do evento Website e Nome do evento Purchase](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/evento-meta.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=a8a14c33d1bfbb6dd2ae3a7727fb5ea1)

Avance até o fim e salve. O evento **Compra Aprovada (Automático)** já nasce ligado na Meta como `Purchase`, com o valor e a moeda vindos do checkout.

**5. Teste**

1. No Gerenciador de Eventos, abra o pixel > **Eventos de teste**, escolha o canal **Site** e copie o `test_event_code`.
2. Na Metrito, edite o destino (lápis no card), ligue o **Modo de Teste** e cole o código.
3. Dispare o evento no site (ou um evento manual em [Sessões](https://docs.metrito.com/tracking/sessoes.md)) e veja ele chegar em **Eventos de teste**.
4. **Desligue o Modo de Teste.**

![Aba Eventos de teste da Meta mostrando o test\_event\_code](https://mintcdn.com/metrito/k3awo8kUSPqFHumn/images/conversoes/meta-codigo-teste.png?fit=max\&auto=format\&n=k3awo8kUSPqFHumn\&q=85\&s=d9b22fbd4b41bdbc9554da914e61a0e2)

Gerenciador de Eventos > o pixel > Eventos de teste > Site.

> [!WARNING]
>
> Com o **Modo de Teste** ligado, o destino manda **tudo** só para o ambiente de teste e as campanhas ficam sem conversão. Desligue assim que terminar.

## Como saber que está tudo certo

* No card do destino aparece a **nota de qualidade** calculada pela Meta. Clique no ícone de gráfico para ver a nota por evento e quais dados a Meta recebeu (e-mail, telefone, IP...).
* Em [Sessões](https://docs.metrito.com/tracking/sessoes.md), clique em um evento para ver o **payload exato** enviado à Meta e a resposta da API de Conversões.
* No Gerenciador de Eventos, na **Visão geral** do pixel, o evento aparece com as integrações **Navegador** e **Servidor**.

## Problemas comuns

> [accordion] A Validação do Pixel falha
>
> Confira se o token foi gerado **no mesmo pixel** do ID informado e se não sobrou espaço no começo ou no fim. Token de outro pixel ou de outro Business Manager é recusado.

> [accordion] A compra aparece em dobro no Gerenciador de Anúncios
>
> Existe outra fonte mandando a mesma compra para o mesmo pixel: pixel configurado dentro do checkout, plugin da loja ou código base do pixel colado no site. Deixe a Metrito como fonte única e desligue as outras.

> [accordion] A nota de qualidade está baixa
>
> A nota sobe com identificadores. Peça e-mail e telefone no formulário e no checkout, e garanta que o checkout esteja conectado: é dele que vêm os dados do comprador.

> [accordion] Uso pixel de mensagem e o evento não aparece
>
> O evento precisa estar com **Tipo do evento** **Business Messaging** e um nome suportado nesse ambiente (eventos personalizados não são aceitos). Veja [WhatsApp](https://docs.metrito.com/tracking/whatsapp.md).

## Próximos passos

> [card] [Google Ads](https://docs.metrito.com/tracking/conversoes/google-ads.md)
>
> Mande o mesmo evento como conversão no Google Ads.

> [card] [TikTok Ads](https://docs.metrito.com/tracking/conversoes/tiktok-ads.md)
>
> Mande o mesmo evento como conversão no TikTok Ads.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.