> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/tictools-integracoes/pixels/facebook-meta-ads.md).

# Facebook- Meta Ads

### Índice

* [O que são os eventos do Facebook Pixel](#o-que-sao-eventos-de-pixel-e-como-integrar-o-facebook-a-ds-pixel-na-ticto-de-forma-pratica-e-rapida)
* [Obtendo as informações do Facebook](#parte-1-coletando-as-informacoes-no-facebook)
  * [Acessando o Gerenciador de Eventos](#id-1.1-acessando-o-gerenciador-de-eventos)
  * [Localizando o ID do Pixel](#id-1.2-copiando-o-id-do-pixel)
  * [Gerando o Token da API de Conversões](#id-1.3-gerando-o-token-de-acesso-da-api-de-conversoes)
* [Liberando os domínios da Ticto no Facebook](#parte-2-liberando-os-dominios-da-ticto-no-facebook)
* [Integrando o Facebook Pixel à Ticto](#parte-3-cadastrando-o-pixel-na-ticto)
* [Configurando os eventos de rastreamento](#parte-4-configurando-os-eventos)
* [Gerenciando pixels cadastrados](#gerenciando-pixels-cadastrados)
* [Validando a integração](#parte-5-validando-se-os-eventos-estao-chegando)

***

### 📘 O que são eventos de Pixel e como integrar o Facebook Ads Pixel na Ticto de forma prática e rápida

Os eventos são ações específicas que os usuários realizam no seu checkout e que o pixel captura para análise. Com eles você acompanha a eficácia das suas campanhas, otimiza anúncios para conversões reais e cria públicos personalizados para remarketing.

Veja como conectar o Facebook Pixel e a API de Conversões ao seu produto na Ticto para rastrear eventos, otimizar campanhas e criar públicos de remarketing com precisão.

{% hint style="info" %}
Adicione o script de repasse automático de UTMs na sua página de vendas para aumentar a precisão dos eventos. [Saiba mais](https://echo.ticto.app/)\
[Ticto Echo -Trackeamento oficial ticto UTMs](/sou-produtor/trackeamento/ticto-echo-trackeamento-oficial-ticto-utms.md)
{% endhint %}

***

### 🔍 Parte 1 — Coletando as informações no Facebook

Antes de configurar na Ticto, você precisará de duas informações do Facebook: o **ID do Pixel** e o **Token de Acesso da API de Conversões**. Siga os passos abaixo para localizar cada uma delas.

#### 1.1 — Acessando o Gerenciador de Eventos

{% stepper %}
{% step %}
Acesse o [Facebook Business Manager](https://business.facebook.com/) e faça login com sua conta

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FWmmk6sTI0F3GAZEwxgax%2Fimage.png?alt=media&amp;token=7449e9a7-4da1-432f-b06c-c1d841ce1f99" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No menu principal, clique em **Gerenciador de Eventos**

Se não encontrar, acesse diretamente: [business.facebook.com/events\_manager](https://business.facebook.com/events_manager)

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F5v1WekRIi1gjQsOqRZ9e%2Fimage.png?alt=media&amp;token=64bb9c35-f8d5-4e1b-87f1-64147da60382" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Na lista de pixels exibida, clique no **pixel correspondente ao seu produto ou escolha para para se conectar a uma nova fonte de dados.**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FQ0pZ77yBHcSOyEEdUYOv%2Fimage.png?alt=media&amp;token=f4ab7ea4-20ee-4876-aedb-db7b53fe3eb4" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

#### 1.2 — Copiando o ID do Pixel

{% stepper %}
{% step %}
Dentro do Gerenciador de Eventos, clique em **Configurações** no menu superior

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FdJL4fAw94DLGp0BHV2FN%2Fimage.png?alt=media&amp;token=d24252b3-c63f-48bd-bf9e-1fd33fb42e66" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Na seção **Informações do pixel**, localize o campo **ID do Pixel**

O ID segue o padrão numérico — exemplo: `1495798531209457`

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FHVES8HykttgroDRQjTLC%2Fimage.png?alt=media&amp;token=9983125d-208a-4242-bf13-146b097f9b97" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Copie o ID e guarde-o. Você vai precisar dele na Parte 3.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
O ID do pixel é **sempre numérico**. Não confunda com o nome do pixel ou com o ID da conta de anúncios.
{% endhint %}

***

#### 1.3 — Gerando o Token de Acesso da API de Conversões

{% stepper %}
{% step %}
Ainda em **Configurações** do Gerenciador de Eventos, role a página até a seção **API de Conversões**
{% endstep %}

{% step %}
Clique em **Gerar token de acesso**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FM4y2hrrSesEhjubau6Z8%2Fimage.png?alt=media&amp;token=4740fff9-cadc-40b6-985d-7df7e2508545" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Copie o token gerado e guarde-o. Você vai precisar dele na Parte 3.

{% hint style="info" %}
É importante salvar este token em um lugar seguro pois ele é gerado uma única vez, caso precise reutilizar em algum outro lugar.

OBS: Isso não impede de gerar um novo token por exemplo.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FSXCYBCw34sq84DvPZQgQ%2Fimage.png?alt=media&amp;token=9f390eed-2646-4888-8a2b-152ec84d5c7c" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="success" %}
O uso da API de Conversões é **altamente recomendado**. Ela garante que eventos como **Purchase** cheguem ao Facebook mesmo quando o pixel do navegador não consegue disparar — como nos casos de bloqueadores de anúncios.
{% endhint %}

{% hint style="info" %}
Para mais informações sobre a API de Conversões, acesse o [guia oficial do Facebook](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started).
{% endhint %}

***

### 🌐 Parte 2 — Liberando os domínios da Ticto no Facebook

Para que o pixel e a API de Conversões funcionem corretamente, é necessário adicionar os domínios da Ticto na lista de domínios permitidos do Facebook.

Para que os eventos partindo do checkout da Ticto sejam recebidos corretamente pelo Facebook, é necessário adicionar os domínios da Ticto na **lista de permissão de tráfego** do seu pixel.

{% stepper %}
{% step %}
Acesse o [Gerenciador de Eventos do Facebook](https://business.facebook.com/events_manager) e selecione o seu pixel&#x20;

{% endstep %}

{% step %}
No menu superior, clique em **Configurações**

{% endstep %}

{% step %}
Role a página até a seção **Permissões de tráfego - Sites**

{% endstep %}

{% step %}
Clique em **Editar na Lista de permissão**

{% endstep %}

{% step %}
Adicione os domínios abaixo, um de cada vez:

```
ticto.io
ticto.app
```

{% endstep %}

{% step %}
Salve as alterações ✅

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FriQWMckNM81SbB4BaQpn%2Fimage.png?alt=media&amp;token=94f80aaa-87e2-4e2b-9555-9c941ed29bdf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
&#x20;Somente os domínios adicionados à lista de permissão podem enviar eventos da web para o Facebook. Sem adicionar `ticto.io` e `ticto.app`, os eventos do checkout **não serão recebidos**.&#x20;
{% endhint %}

{% hint style="warning" %}
Sem a liberação dos domínios `ticto.io` e `ticto.app`, os eventos podem ser bloqueados ou não atribuídos corretamente às suas campanhas.
{% endhint %}

***

### ⚙️ Parte 3 — Cadastrando o pixel na Ticto

Com o ID do Pixel e o Token de Acesso em mãos, agora é só configurar na plataforma.

{% stepper %}
{% step %}
Faça login na sua conta Ticto e clique em **TICTOOLS** no menu à esquerda

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYHp96q90S9yQQHDwGdDt%2Fimage.png?alt=media&amp;token=4ff3a5a3-792f-4aef-ad7f-ed524b682518" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Dentro de Tictools, selecione a opção **PIXEL DE RASTREAMENTO**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F366jdX0zngJ6h4Jqfa2A%2Fimage.png?alt=media&amp;token=847b8667-adcf-4ab2-9292-161a70431f02" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique no card **FACEBOOK**

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FfdtwR770T8CvW8IHR4kx%2Fimage.png?alt=media&amp;token=f3e4841c-5dc8-433f-be42-f0159d6b17ee" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em +ADICIONAR

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F56HUudqavQWp1zJSnNPw%2Fimage.png?alt=media&amp;token=4addd5d7-c8dd-4a16-9328-28ca75e74aed" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione o **produto** que deseja vincular ao pixel e Cole o **ID do Pixel** copiado na Parte 1 no campo indicado.

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FAPPswvvOnO0AZ82JPdxI%2Fimage.png?alt=media&amp;token=b1717cef-b04a-44f5-b9e8-a6b967d97588" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Ative o toggle **Usar API de Conversões** (recomendado) e cole o **Token de Acesso** copiado na Parte 1

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FAeHVcCXhurQNdPUtKjxk%2Fimage.png?alt=media&amp;token=9c7ac794-ce22-462a-8ae8-b4c89925623a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Configure os eventos desejados (veja a Parte 4) e clique em **Salvar** ✅
{% endstep %}
{% endstepper %}

***

### 📡 Parte 4 — Configurando os eventos

Após preencher o pixel, ative ou desative os eventos que deseja rastrear no checkout:

| Evento               | O que rastreia                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PageView**         | Visita a uma página do checkout                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **AddToCart**        | Usuário adiciona ao carrinho                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **InitiateCheckout** | Usuário inicia o processo de compra                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **AddPaymentInfo**   | <p>Usuário insere os dados de pagamento<br><br><strong>AddPaymentInfo</strong> — Disparado <strong>1x por sessão</strong> quando o comprador preenche nome + e-mail e/ou telefone válido (DDI +55) e avança/interage com a etapa de pagamento (multi-step, one-page ou dados pré-preenchidos por URL). Envia <code>em</code> e <code>ph</code> para a Meta; se não houver e-mail (ex.: fluxo "sem e-mail"), envia apenas <code>ph</code>. Não dispara se os dados pessoais estiverem vazios ou inválidos.</p> |
| **Purchase**         | Compra concluída com sucesso                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FgTOPUqEhPn4QquKOzJcb%2Fimage.png?alt=media&amp;token=b578c5ab-e994-45b0-ba16-547138c0a5df" alt=""><figcaption></figcaption></figure></div>

#### Configurações avançadas do evento Purchase

{% hint style="info" %}
**Enviar Purchase para Pix somente após pagamento?**\
Quando ativado, o evento só é disparado após a confirmação do pagamento via Pix. Caso desativado, o evento é enviado assim que o Pix é gerado, sem necessidade de pagamento.
{% endhint %}

{% hint style="info" %}
**Alterar valores enviados?**\
Permite ajustar os valores transmitidos com os eventos, útil para configurações personalizadas de análise por método de pagamento — Cartão de crédito, Pix ou Boleto.
{% endhint %}

{% hint style="warning" %}
**Order Bumps não geram Purchase independente.**\
Ao finalizar uma compra com um ou mais Order Bumps, o evento **Purchase** deve ser disparado **apenas 1 vez**, referente à venda do produto principal. Order Bumps não são tratados como conversões independentes — se cada bump disparasse seu próprio Purchase, o número de conversões reportado à Meta ficaria inflado, distorcendo métricas como CPA e ROAS.
{% endhint %}

### 🗂️ Gerenciando pixels cadastrados

Após salvar, o pixel aparecerá listado na tela **Tictools / Pixels**. Clique no botão **⋮ Ações** (três pontos) para acessar as opções disponíveis:

| Opção           | O que faz                                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| 👁️ **Eventos** | Visualiza os eventos disparados: nome do evento, cidade, país, IP, código da oferta, código do pedido e data |
| ✏️ **Editar**   | Permite alterar o produto, o ID do pixel, o token da API ou as configurações de eventos                      |
| 🗑️ **Remover** | Remove o pixel cadastrado daquele produto                                                                    |

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Fbt4K0vkk03v85qrJkJmc%2Fimage.png?alt=media&amp;token=8d67fea7-0cfb-4e92-98ff-3df914dc654d" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Ao clicar em **Remover**, o pixel será desvinculado imediatamente. Essa ação não pode ser desfeita.
{% endhint %}

***

### ✅ Parte 5 — Validando se os eventos estão chegando

Após salvar o pixel na Ticto, use a ferramenta de **Eventos de teste** do Facebook para confirmar que os eventos estão sendo recebidos corretamente antes de ir ao ar.

{% stepper %}
{% step %}
&#x20;Acesse o [Gerenciador de Eventos do Facebook **e clique em Conjuntos de dados no menu lateral esquerdo**](https://business.facebook.com/events_manager) e clique em **Conjuntos de dados** no menu lateral esquerdo&#x20;

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FdAZ5qStVpG3JocAkrhMo%2Fimage.png?alt=media&amp;token=073a42a9-7d70-4043-aff3-4057abc333ce" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione o pixel que você acabou de configurar na Ticto

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FXUg8dbucsv2RXr8krYNx%2Fimage.png?alt=media&amp;token=09908109-1899-469f-9f19-342409614f6e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No menu superior, clique na aba Eventos de teste

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FZBGX9JxBgGJmguRmGt3c%2Fimage.png?alt=media&amp;token=2a35ed68-887d-415e-b648-c04f5f17f2e3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No campo Selecione um canal de marketing, mantenha a opção Site

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FFBUN0MPRv3ylEsaFDMDW%2Fimage.png?alt=media&amp;token=b0135849-d810-4b0a-a83e-086268bd505a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Abra o link de checkout do seu produto em uma nova aba e navegue pelas etapas — adicione ao carrinho, preencha os dados e simule uma compra

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FfGbaFBKbsdJzvDDFIJ73%2Fimage.png?alt=media&amp;token=4522290a-0e6c-44f3-8261-dae25dcbd147" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Volte à aba de Eventos de teste e verifique na tabela Eventos recebidos se os eventos estão aparecendo com o status Processado ✅<br>
{% endstep %}

{% step %}
META PIXEL HELP

{% hint style="info" %}
**META PIXEL HELP**: Existe uma forma pratica de testar os eventos através do plugin instalado nas extensões do seu navegador de internet.

**Recomendamos** a instalação através da url :<https://chromewebstore.google.com/detail/meta-pixel-helper-%E2%80%93-unoff/maldojaignkebbkfjjdmaildchamfbnm?pli=1>\
\
Existem alguns plugins que  podem não funcionar no rastreamento dos eventos no checkout, verifiquem a versão correta.

{% endhint %}

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FO7kQ2GmGB0CKympGra0Y%2Fimage.png?alt=media&amp;token=504a8bf9-8b0d-42f1-abaf-99d3408337af" alt=""><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Se os eventos aparecerem com o status **Processado** na coluna, a integração está funcionando corretamente. Você verá os eventos `AddToCart`, `AddPaymentInfo`, `Purchase` e demais conforme as etapas percorridas no checkout.

Caso nenhum evento apareça na tabela, verifique se:

* Os domínios `ticto.io` e `ticto.app` estão na **lista de permissão de tráfego** (Parte 2)
* O **ID do Pixel** foi inserido corretamente na Ticto (Parte 3)
* O pixel está vinculado ao **produto correto** na Ticto
  {% endhint %}

***