> 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

Rastreie conversões, otimize anúncios e crie públicos personalizados com o Facebook Pixel e a API de Conversões.

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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-d27e142533674931c1a79f902ec5f87e9ab94174%2Ffb-pixel-1.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-f20a62587f60b6097d48e2fb5c3cbbbd20ed240b%2Ffb-pixel-2.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-1366554b2ee594a13b94f00c336937ae318d75ee%2Ffb-pixel-3.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-dbfa7dc6693540a3f8b79e4479c30988e894cde7%2Fextensao-facebook-pixel.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-7192aadd3009b913533d2b8b726d9b2fa3acb466%2Ffb-pixel-5.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-2276afc6f6998b18b3d90639feee332056e98ba3%2Ffb-pixel-6.png?alt=media" 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="https://3828460146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvGtiaXq31HNyQgXlAR%2Fuploads%2Fgit-blob-e0c907220a7f669690518117f9347dcb64a89d03%2Ffb-pixel-7.png?alt=media" 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 %}