> For the complete documentation index, see [llms.txt](https://help.maisfy.com.br/maisfy-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.maisfy.com.br/maisfy-help/ferramentas/pixel.md).

# Pixel

Menu lateral → **Ferramentas** → **Pixel**.

O pixel avisa a sua plataforma de anúncio quando algo acontece no checkout, para as campanhas aprenderem quem compra de você.

![Lista de pixels cadastrados](https://3344509428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0KchSWN381W9S4GFEfY%2Fuploads%2FZl3huBueJZbAEVVwXxbs%2Fft-pixel-lista.jpg?alt=media)

{% hint style="warning" %}
**Cadastrar o pixel aqui não basta.** Ele só rastreia depois de ser **acrescentado ao checkout** — são dois passos, e o segundo é o que mais se esquece. Depois dá para **testar sem vender**, no passo 3.
{% endhint %}

{% hint style="info" %}
**Não confunda com o Pixel da Maisfy.** Este aqui manda dados para a **plataforma de anúncio**. O que alimenta o **Maisfy Analytics** é outro e fica em Maisfy Analytics. São coisas diferentes e você pode usar as duas.
{% endhint %}

## Passo 1 — cadastrar o pixel

Cinco plataformas: **Facebook**, **TikTok**, **Google Ads**, **Google Analytics** e **Google Tag Manager**.

Os campos comuns a todas:

| Campo             | O que é                                           |
| ----------------- | ------------------------------------------------- |
| **Plataforma**    | Qual das cinco                                    |
| **Pixel ID**      | O identificador do pixel na plataforma de anúncio |
| **Nome do Pixel** | Como você identifica na lista                     |
| **Nota**          | Uma observação sua — útil quando você tem vários  |

Google Ads, Google Analytics e Google Tag Manager param aí. Facebook e TikTok têm campos próprios.

### Facebook

**Domínio** — apenas o domínio da sua página de vendas, já verificado no Meta. Por exemplo `seusite.com.br`.

* sem `https`
* sem subpáginas
* **não** é o link do checkout da Maisfy

**Token (Conversions API)** — o Access Token do seu Pixel, para ativar eventos via servidor. Gerar em **Events Manager → Pixel → Configurações → Conversions API**.

{% hint style="warning" %}
Use o token **do Pixel certo**, e não compartilhe esse token com ninguém.
{% endhint %}

### TikTok

**Access Token (Events API)** — gerar em **Events Manager → Pixel → Settings → Events API**.

![O painel da TikTok](https://3344509428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0KchSWN381W9S4GFEfY%2Fuploads%2FZ4HKosHFvTgdKx0XmNSI%2Fft-pixel-tiktok-v2.jpg?alt=media)

{% hint style="warning" %}
**O token da TikTok vale para a conta de anúncios inteira**, não só para este pixel. Por isso ele **não é exibido de volta** depois de salvo — na edição o campo aparece vazio e mostra só os primeiros caracteres do que está guardado. Deixar em branco **mantém** o token atual; só preencha para trocar.
{% endhint %}

A TikTok **não tem campo de domínio**, e isso é de propósito: verificação de domínio é exigência da Meta, a TikTok não pede.

## Modo de teste

Só aparece no **Facebook** e na **TikTok**.

O **código de evento de teste** **marca** os eventos deste pixel na aba de testes do Events Manager — serve para você conferir se eles estão chegando. Onde achar: **Events Manager → seu pixel → aba Testar eventos**.

{% hint style="danger" %}
**Marcar não é isolar.** A documentação da Meta é explícita: evento enviado com código de teste **não é descartado** — ele entra no Events Manager e **continua contando** para segmentação e mensuração de anúncios. A TikTok não documenta o efeito em nenhuma direção.

Ou seja: o modo de teste **não protege a sua campanha**. Ele ajuda a diagnosticar, e só. Para conferir sem risco nenhum, use o **Testar pixel** do passo 3.
{% endhint %}

| Campo      | O que acontece                                                                                                              |
| ---------- | --------------------------------------------------------------------------------------------------------------------------- |
| Vazio      | Envio normal                                                                                                                |
| Preenchido | Os eventos vão marcados para a aba de testes — e continuam contando. Vale por **24 horas** e depois volta ao normal sozinho |

{% hint style="info" %}
**Por que expira em 24 horas:** o código é **rotativo** — muda a cada sessão de teste no Events Manager. Um código guardado envelhece e passa a marcar eventos para uma sessão que não existe mais. Para desligar antes, apague o campo e salve.
{% endhint %}

## Passo 2 — acrescentar o pixel ao checkout

Este é o passo que faz o pixel funcionar:

1. **Gerenciar Produtos → Meus Produtos**, abra o produto e vá na aba **Checkouts**
2. No menu de três pontos do checkout, **Personalizar página de checkout**
3. Acrescente um bloco de **Pixel** e selecione o pixel que você cadastrou
4. **Salvar** e **Publicar**

Deu certo quando o indicador **Sem pixel**, no card do checkout, virar **Pixel configurado**.

### O que você configura no bloco

É aqui que se escolhe **quando** o pixel dispara — e não mais na tela de cadastro:

| Evento                             | Quando                                  |
| ---------------------------------- | --------------------------------------- |
| **Ao abrir a página (PageView)**   | A pessoa chega ao checkout              |
| **Ao iniciar o checkout**          | Ela começa a preencher                  |
| **Ao marcar order bump**           | Ela aceita a oferta adicional           |
| **Ao escolher forma de pagamento** | Ela decide como vai pagar               |
| **Ao gerar o pix**                 | O pix é gerado — ainda **não** foi pago |
| **Na compra aprovada**             | A venda se conclui                      |

E também:

* **Tipo de valor** — **Valor Total** ou **Minha Comissão**
* **Executar pixel no cartão?** e **Executar pixel no pix?** — restringe por forma de pagamento

{% hint style="info" %}
Os eventos novos **nascem desligados**, de propósito: ligar sozinhos faria os blocos já configurados mandarem evento que você nunca pediu. Se quiser um deles, ligue você.
{% endhint %}

{% hint style="warning" %}
**"Ao gerar o pix" merece pensar.** Pix é **gerado** num momento e **pago** em outro — às vezes nunca. Disparar conversão na geração infla o resultado da campanha com venda que talvez não aconteça; não disparar deixa a plataforma aprendendo menos. Não existe resposta única: depende de quanto do seu pix costuma ser pago.
{% endhint %}

## Passo 3 — testar sem vender

No mesmo menu de três pontos do checkout, **Testar pixel**. Abre o seu checkout numa aba nova, em **modo diagnóstico**.

A página carrega normal, os seus pixels sobem, e uma **faixa no topo** diz quais carregaram — um por um:

|   | O que a faixa diz                                                 |
| - | ----------------------------------------------------------------- |
| ✅ | *o script carregou e o pixel está recebendo evento*               |
| ❌ | *o script NÃO carregou — confira se o código do pixel está certo* |

Se o script subiu mas o **cookie da plataforma** não apareceu, a faixa avisa também: bloqueador de anúncios costuma ser a causa.

{% hint style="success" %}
**Nada acontece de verdade nessa página.** Ela não registra venda, não cria pedido, não cria conta, não libera acesso e não dispara conversão. Dá para recarregar à vontade — o link vale **15 minutos**.
{% endhint %}

{% hint style="warning" %}
**O que este teste prova, e o que não prova.** Ele prova que o pixel **carrega e recebe evento** — que é a falha mais comum e a mais silenciosa, porque o painel mostra o bloco configurado do mesmo jeito.

Ele **não** prova que uma compra será contada com o valor certo. Nenhuma das plataformas permite testar isso sem gerar uma conversão de verdade na sua campanha.
{% endhint %}

O teste é do **checkout**, não de um pixel: ele confere todos os pixels daquela página de uma vez.

## Na lista de pixels

Cada pixel tem **Editar**, **Detalhes** e **Excluir**. Se o pixel estiver acrescentado a algum checkout, a exclusão avisa — *"Este pixel está sendo utilizado"* — e pede confirmação antes de seguir.

{% hint style="info" %}
O mesmo pixel serve também para a sua Loja Própria, na aba **Pixels** da página de vendas. Sem ele, a venda que vier da loja aparece como tráfego direto no painel.
{% endhint %}

## Sou afiliado — como uso o meu pixel?

O bloco de pixel fica na página do checkout, e quem edita essa página é o **produtor**. Então o caminho é:

1. Cadastre o seu pixel em **Ferramentas → Pixel**
2. Mande o **nome** dele ao produtor — é por esse nome que ele te acha na lista
3. Ele acrescenta o bloco e seleciona o seu pixel

O painel do produtor aceita pixel de afiliado; não é preciso que o pixel seja dele.