> For the complete documentation index, see [llms.txt](https://ereemby.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ereemby.gitbook.io/docs/informacoes-gerais/plugins/marketing/facebook-pixel.md).

# Facebook Pixel

### O que você precisa

Você pode integrar a Ereemby ao Meta com **ID do Pixel** e, opcionalmente, com **Token Pixel API**:

* **ID do Pixel**: obrigatório para ativar a integração.
* **Token Pixel API (recomendado)**: adiciona envio via **Conversions API (CAPI)**. Mais estável. Menos perda por bloqueadores.

Se você quiser usar o **Token Pixel API**, também precisa preencher o **ID do Pixel**.

{% hint style="info" %}
O cenário recomendado é preencher **os dois campos**: **ID do Pixel** + **Token Pixel API**.\
O ID identifica o Pixel. O token ativa o envio server-side via CAPI.
{% endhint %}

{% hint style="danger" %}
O **Token Pixel API** é confidencial.\
Não compartilhe com terceiros.
{% endhint %}

{% stepper %}
{% step %}

### Abra o Gerenciador de Eventos e selecione o Pixel

1. Entre no **Meta Business**.
2. Abra o **Gerenciador de Eventos**.
3. No menu lateral, vá em **Fontes de dados**.
4. Selecione o **Pixel** correto da sua conta.

{% hint style="info" %}
Se você não consegue ver o Pixel, falta permissão no Business Manager.\
Peça acesso de **Administrador** ou **Anunciante**.
{% endhint %}
{% endstep %}

{% step %}

### Copie o ID do Pixel

Com o Pixel selecionado:

1. Vá em **Configurações** (do Pixel).
2. Procure por **ID do Pixel**.
3. Copie o número (ex.: `123456789012345`).

{% hint style="info" %}
Você vai usar esse ID em qualquer integração.\
Ele é obrigatório, inclusive quando você também usar o **Token Pixel API**.
{% endhint %}
{% endstep %}

{% step %}

### Gere o Token Pixel API (Conversions API)

Ainda nas configurações do Pixel:

1. Encontre a seção **API de Conversões** (Conversions API).
2. Clique em **Gerar token de acesso** (ou **Generate access token**).
3. Copie o token gerado.

Guarde esse token.\
Use esse token junto com o **ID do Pixel** para ativar a **Conversions API**.
{% endstep %}

{% step %}

### Insira na Ereemby

1. Na Ereemby, vá em **Plugins → Marketing → Facebook Pixel**.
2. Preencha os campos conforme o seu cenário:

{% tabs %}
{% tab title="ID do Pixel + Token Pixel API" %}

1. Cole o **ID do Pixel** no campo correspondente.
2. Cole o **Token Pixel API** no campo correspondente.
3. Salve.
   {% endtab %}

{% tab title="Somente ID do Pixel" %}

1. Cole o **ID do Pixel** no campo correspondente.
2. Deixe o campo **Token Pixel API** vazio.
3. Salve.
   {% endtab %}
   {% endtabs %}

{% hint style="warning" %}
Se você preencher o **Token Pixel API** sem o **ID do Pixel**, a integração não funciona corretamente.
{% endhint %}
{% endstep %}

{% step %}

### Teste se está funcionando

1. No **Gerenciador de Eventos**, abra **Eventos de teste**.
2. Faça uma navegação de teste na sua loja e finalize uma compra.
3. Confirme se os eventos aparecem como recebidos.

{% hint style="info" %}
Para validação final, confira também a coluna **Diagnóstico** do Pixel.\
Ela mostra avisos de integração e possíveis duplicidades.
{% endhint %}
{% endstep %}
{% endstepper %}

### Problemas comuns

* **Conversões duplicadas**
  * Você já dispara eventos via **GTM**, app de terceiros, ou script customizado.
  * Revise se existe outra integração do Meta ativa fora da Ereemby.
* **Não consigo gerar o token**
  * Você não tem permissão no Business Manager.
  * O Pixel não está na sua conta correta.
* **Preenchi o token e não funcionou**
  * O **ID do Pixel** não foi preenchido.
  * O token foi gerado para outro Pixel.
* **Eventos não aparecem no teste**
  * Confira se você selecionou o Pixel certo.
  * Desative bloqueadores (AdBlock) para testar via navegador.
  * Aguarde alguns minutos. O Gerenciador de Eventos pode atrasar a exibição.