# Facebook Pixel

O Pixel do Facebook permite rastrear as ações dos visitantes na sua loja para otimizar campanhas de anúncios e aumentar suas vendas.

Com o Pixel você pode:

* **Mostrar anúncios para as pessoas certas** — Encontre novos clientes ou alcance pessoas que já visitaram sua loja ou adicionaram produtos à sacola
* **Gerar mais vendas** — O Facebook otimiza automaticamente seus anúncios para alcançar pessoas mais propensas a comprar
* **Mensurar resultados** — Acompanhe o retorno dos seus anúncios com dados reais de conversão

## Como configurar

{% stepper %}
{% step %}
**Acesse as Configurações do seu negócio no Meta**

Ao lado do seu perfil comercial, clique no ícone de **engrenagem** para acessar as Configurações do negócio.
{% endstep %}

{% step %}
**Abra Conjuntos de dados**

No menu lateral, clique em **Fontes de dados** para expandir o submenu e depois em **Conjuntos de dados**.

<figure><img src="/files/16JByHOIpi0exRIcopz0" alt=""><figcaption><p>Acesse as Configurações do negócio pelo ícone de engrenagem</p></figcaption></figure>
{% endstep %}

{% step %}
**Crie um novo conjunto de dados (Pixel)**

Clique em **+ Adicionar** no canto superior direito. No modal **Conectar seus dados**, clique em **Criar conjunto de dados**.

<figure><img src="/files/HGLj1mN0NbyDQdRMGZU5" alt=""><figcaption><p>Fontes de dados > Conjuntos de dados</p></figcaption></figure>
{% endstep %}

{% step %}
**Copie o ID do Pixel**

Após a criação, o pixel aparece na lista. Clique sobre ele para abrir o painel lateral e copie o número exibido em **Identificação** (semelhante a `1067829918156799`).

<figure><img src="/files/f0I4am83B0VLCEM9vKZB" alt=""><figcaption><p>Criar conjunto de dados</p></figcaption></figure>
{% endstep %}

{% step %}
**Configure no painel DeliveryVip**

No menu lateral, acesse **Extensões** e clique em **Facebook Pixel**.
{% endstep %}

{% step %}
**Cole o ID do Pixel**

No campo **Número de identificação do pixel**, cole o ID copiado do Facebook.
{% endstep %}

{% step %}
**Ative a extensão**

Ative o toggle e clique em **Salvar**. O Pixel já está integrado à sua loja.
{% endstep %}
{% endstepper %}

<figure><img src="/files/9QCyIRsDiOvGdm3AI5u7" alt=""><figcaption><p>Configuração do Facebook Pixel</p></figcaption></figure>

## API de Conversões

A API de Conversões do Facebook envia os eventos da sua loja diretamente para o Facebook pelo servidor (server-side), sem depender apenas do navegador do cliente. Isso melhora a precisão dos dados, especialmente quando navegadores bloqueiam cookies ou scripts de rastreamento.

{% hint style="info" %}
A API de Conversões funciona em conjunto com o Pixel. Recomendamos configurar ambos para ter dados mais completos e confiáveis.
{% endhint %}

### Como configurar a API de Conversões

{% stepper %}
{% step %}
**Abra o Gerenciador de Eventos**

Nas **Configurações do negócio**, acesse **Fontes de dados** > **Conjuntos de dados**. Clique no pixel desejado para abrir o painel lateral e depois clique nos **três pontinhos (...)** e selecione **Abrir no Gerenciador de Eventos**.

<figure><img src="/files/NlQmDOUnad2I4uO11esC" alt=""><figcaption><p>Três pontinhos > Abrir no Gerenciador de Eventos</p></figcaption></figure>
{% endstep %}

{% step %}
**Gere o Token de acesso**

No Gerenciador de Eventos, clique na aba **Configurações**. Na seção **Configurar integração direta**, clique em **Gerar token de acesso**.

<figure><img src="/files/BtFLm2ef7ThzbPWKXX4C" alt=""><figcaption><p>Aba Configurações > Gerar token de acesso</p></figcaption></figure>
{% endstep %}

{% step %}
**Copie o Token gerado**

O token será exibido na tela. Copie-o imediatamente e salve em um lugar seguro.

{% hint style="warning" %}
O Facebook não armazena esse token. Após fechar a tela, não será possível recuperá-lo — será necessário gerar um novo.
{% endhint %}

<figure><img src="/files/try9fGa47kftfRzsx2MU" alt=""><figcaption><p>Token de acesso gerado</p></figcaption></figure>
{% endstep %}

{% step %}
**Cole o Token no painel DeliveryVip**

No painel, acesse **Extensões** > **Facebook Pixel** e cole o token no campo **Token da API de conversões do Facebook**. Clique em **Salvar**.
{% endstep %}
{% endstepper %}

### Código de evento de teste

O campo **Código do evento de teste da API de conversões do Facebook** é usado para validar a integração durante a configuração. O código de teste pode ser encontrado no Gerenciador de Eventos do Facebook, na aba **Eventos de teste**.

{% hint style="warning" %}
O código de teste deve ser usado apenas durante a configuração. Após validar que os eventos estão chegando corretamente, remova o código para que os eventos passem a ser contabilizados nas campanhas.
{% endhint %}

## Eventos rastreados

A integração envia automaticamente os seguintes eventos para o Facebook:

| Evento               | Quando é disparado                                |
| -------------------- | ------------------------------------------------- |
| **PageView**         | A cada novo acesso a uma página na loja           |
| **ViewContent**      | Quando um visitante acessa a página de um produto |
| **AddToCart**        | Quando um visitante adiciona um produto à sacola  |
| **InitiateCheckout** | Quando um visitante inicia o checkout             |
| **Purchase**         | Quando um visitante completa uma compra           |

{% hint style="info" %}
Todos os eventos são enviados tanto pelo Pixel (navegador) quanto pela API de Conversões (servidor), quando ambos estão configurados. O Facebook faz a deduplicação automática para evitar contagem duplicada.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://delivery.ajuda.cc/geral/extensoes/facebook-pixel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.