# Conectar o Pixel e a Conversions API do Meta ao cPixel {#doc-title}

Por [B2B Gold](/about/#how-we-write) Atualizado em 25 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/docs/cpixel/connect-meta/) [Página do cPixel](/shopify/cpixel/) [cPixel na Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-meta&utm_term=docs-header)

## Como conecto o Meta ao cPixel? {#how-do-i-connect-meta-to-cpixel}

No cPixel, abra Destinos, escolha o Meta e cole dois valores do Meta Events Manager: o Pixel ID, em Settings do dataset, e um token de acesso da Conversions API, gerado mais abaixo, na mesma aba. Escolha Set up without Dataset Quality API quando o Meta perguntar. Depois acompanhe a resposta do Meta a cada envio pelo servidor no Ao vivo.

### Cole os valores no cPixel {#paste-them-into-cpixel}

1. No cPixel, abra **Destinos** e clique no ícone do Meta em **Conectar uma plataforma**. **Configurar Meta** abre em **Cole seus IDs**.
2. Cole o **ID do pixel / conjunto de dados** ([onde encontrar](#where-do-i-find-my-meta-pixel-id)) e o **Token de acesso da Conversions API** ([como conseguir um](#how-do-i-get-a-conversions-api-access-token)). Sem o token, a conta fica **Só navegador**.
3. Nomeie a conta em **Dê um nome a esta conta (opcional)**, se quiser, depois clique em **Continuar**.
4. Em **Escolha as opções**, mantenha **Enviar eventos pelo navegador** e **Enviar eventos pelos nossos servidores** marcados. Mantenha **Não — o cPixel cuida do Meta (recomendado)** a menos que outra ferramenta envie para este dataset: apesar do nome, **Sim — mantenha-o, e o cPixel para de enviar o Meta pelo servidor** interrompe os envios do cPixel pelo navegador e pelo servidor para ele ([um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)). **Configurações avançadas** é opcional ([regras de pedidos](/pt-br/docs/cpixel/order-rules/)).
5. Clique em **Salvar e continuar**. **Teste** confirma **Meta está conectado**.

Você pode conectar vários pixels do Meta, que compartilham os IDs de evento do cPixel, mas não o mesmo pixel duas vezes.

## Onde encontro o Pixel ID do Meta? {#where-do-i-find-my-meta-pixel-id}

No [Meta Events Manager](https://business.facebook.com/events_manager2), selecione o dataset web da sua loja e abra **Settings**: o **Pixel ID** ali, com cerca de 15 dígitos, vai no campo **ID do pixel / conjunto de dados** do cPixel. Em quase todo o resto, o Meta chama isso de dataset ID.

1. Encontre seu dataset. Um dataset web, o tipo usado por uma loja Shopify, tem um ícone de monitor; um ícone de celular indica um dataset de app.
2. Selecione-o. Um dataset novo mostra **Your pixel hasn’t received any activity** até que os eventos comecem a chegar.
3. Abra **Settings** e copie o número em **Details** → **Pixel ID**.

> **Dica:** Dois datasets podem ter o mesmo nome. Se só um deles conseguir gerar um token, são datasets diferentes: confira o ID.

## Como obtenho um token de acesso da Conversions API? {#how-do-i-get-a-conversions-api-access-token}

Na mesma aba **Settings**, em **Conversions API**, escolha **Set up without Dataset Quality API** e clique em **Generate access token**. Marque o dataset desta loja e copie o token, uma string longa que começa com `EAA`, imediatamente: o Meta o mostra uma única vez e não o armazena.

1. Role **Settings** até **Conversions API**. A captura de tela abaixo, assim como a do próprio Meta, mostra as opções em **Set up direct integration**; o texto do guia do Meta diz **Set up manually**. Use o que aparecer na sua conta.
2. Escolha **Set up without Dataset Quality API** ([por quê](#should-i-set-up-the-dataset-quality-api)).
3. Clique em **Generate access token** e marque o dataset desta loja.
4. Copie o token antes de fechar o painel. O aviso do Meta é literal: **Copy and save this token somewhere safe. It won’t be stored by Facebook.**
5. Cole-o no campo **Token de acesso da Conversions API** do cPixel.

> **Importante:** Um **Generate access token** acinzentado (ao passar o mouse: **Missing prerequisite**) significa que você não é admin nem desenvolvedor do portfólio de negócios dono do dataset ([Meta](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started)); um dataset criado numa conta de anúncios pessoal causa isso. Peça a um admin do portfólio, ou [adicione o dataset ao portfólio](https://www.facebook.com/business/help/1910428752389787) em **Data sources**, dentro de **Settings** no Meta Business Suite.

Um token funciona apenas para os datasets marcados. O Meta não informa por quanto tempo um token do Events Manager dura, e ele para de funcionar se o system user perder acesso ao dataset, o que o Meta reporta como um erro de permissão.

## Devo configurar o Dataset Quality API? {#should-i-set-up-the-dataset-quality-api}

Não. O cPixel não precisa dele, e o diálogo do Meta avisa que, depois que um dataset usa a Quality API, não é possível desativá-la atualmente. O Meta a marca como **Recomendado** e diz que ela adiciona métricas como a taxa de correspondência de eventos; um token criado sem ela envia os mesmos eventos.

Sem ela, a página **Qualidade dos eventos** do cPixel pode exibir **Este tipo de token não consegue ler a pontuação da Meta**, a única coisa que a Quality API acrescentaria ali. O envio não é afetado.

## O que o cPixel envia para o Meta? {#what-does-cpixel-send-to-meta}

PageView, ViewContent, Search, AddToCart, InitiateCheckout e AddPaymentInfo saem tanto do navegador do comprador quanto dos servidores do cPixel, compartilhando um único ID de evento. O Purchase sai dos servidores, reconstruído a partir do pedido da Shopify. Não há configuração de deduplicação a ajustar.

- O Purchase do navegador fica desligado enquanto o envio pelo servidor do cPixel para esse pixel está ativo. Ele só dispara enquanto esse envio está desligado ou pausado: sem token ou com um token rejeitado, com o envio pelo servidor desligado, ou com a pausa do plano Free.
- A frente do navegador roda no web pixel da Shopify em todas as páginas, incluindo o checkout, então não precisa do app embed.
- Os envios pelo servidor levam e-mail, telefone, IDs de cliente e de dispositivo com hash, `_fbp` e `_fbc`, endereço IP e user agent, e por padrão uma localização com hash deduzida do IP. O Meta exige consentimento de marketing: veja [o que o cPixel envia, e como o consentimento muda isso](/pt-br/docs/cpixel/event-quality-and-consent/).

## Devo usar um código de evento de teste? {#should-i-use-a-test-event-code}

Só se você quiser usar **Testar conexão**. O cPixel usa o código para esse teste e para uma verificação noturna de uma conta sem envio bem-sucedido há 7 dias, nunca para eventos reais, seja o que for que a nota do assistente diga. O teste envia um PageView real, que o [Meta mantém](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api) para segmentação e mensuração.

- Copie o código, que começa com `TEST`, da aba **Test events** do seu dataset para **Código de evento de teste (opcional)**, depois clique em **Testar conexão**: **Working** significa que o Meta aceitou o evento de teste.
- Eventos reais não levam o código, então suas compras não vão aparecer em **Test events**; confira o **Overview** do dataset.

## Como confiro se funcionou? {#how-do-i-check-it-worked}

Inicie uma sessão no **Ao vivo** e navegue pela sua loja: cada envio pelo servidor para o Meta mostra a resposta do Meta, **Aceito**, **Rejeitado** ou **Erro**, com o status HTTP. Depois confirme no Events Manager, onde o [Meta diz](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api) que você deve ver os eventos em até 20 minutos.

1. No cPixel, abra o **Ao vivo** e clique em **Iniciar sessão**.
2. Em outra aba, veja um produto e adicione-o ao carrinho.
3. Abra uma linha **Servidor**: em **Enviado para**, **Meta** mostra **Aceito**. Linhas de navegador não trazem resposta.
4. Em **Destinos**, a conta agora mostra **Verificado**.
5. No Events Manager, o **Overview** do dataset mostra **Conversions API** como a integração do Purchase e **Multiple**, ou seja, navegador e servidor, para os outros eventos.

Para ver uma compra, faça um pedido real: por padrão, o cPixel ignora pedidos de teste.

## E se não funcionar? {#what-if-it-doesnt-work}

Se o Meta rejeitar o token de acesso como inválido ou expirado, o cPixel marca a conta como **Token inválido**, interrompe os envios pelo servidor e envia um alerta crítico para o endereço de contato da sua loja; o **Início** mostra **Corrigir Meta**. O rastreamento pelo navegador continua.

1. Clique em **Corrigir Meta** no **Início**, ou em **Gerenciar** ao lado da conta em **Destinos**.
2. [Gere um novo token](#how-do-i-get-a-conversions-api-access-token) e cole-o sobre **Salvo — cole um novo para substituir**.
3. Clique em **Continuar**, depois em **Salvar e continuar**.

| What you see | What to do |
| --- | --- |
| **Generate access token** aparece acinzentado | Consiga acesso de admin ou desenvolvedor ao portfólio de negócios do dataset |
| **Testar conexão**: a plataforma rejeitou este token | Gere um novo token |
| **Testar conexão**: a plataforma recusou o evento de teste desta conta | O ID está errado, ou o token pertence a outro dataset |
| **Meta rejected an event** no **Início**, citando permissões | Restaure o acesso do system user, ou gere um novo token |
| Uma compra mostra **Ignorado** no Ao vivo | Leia o motivo, depois veja [compras que não aparecem](/pt-br/docs/cpixel/purchases-missing/) |
| Compras contadas em dobro | Outra ferramenta envia para este dataset: [um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/) |

**Remover** em **Gerenciar Meta** interrompe os envios e exclui o token armazenado; você pode reconectar com o mesmo ID. Guia oficial do Meta: [Conversions API: get started](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started).

## Relacionados {#related}

- [Acompanhe cada envio no Ao vivo](/pt-br/docs/cpixel/live-events/)
- [Um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)
- [Como o cPixel conta cada compra uma única vez](/pt-br/docs/cpixel/deduplication/)
- [Configure a Conversions API na Shopify](/pt-br/blog/shopify-conversions-api/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Instalar grátis pela Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-meta&utm_term=card) [Planos e preços](/shopify/cpixel/#pricing)

Precisa de ajuda com o cPixel? Envie um e-mail para [support@b2bgold.app](mailto:support@b2bgold.app).