> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/geral/extensoes/facebook-pixel.md).

# 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 %}