Conectar o Pixel e a Conversions API do Meta ao cPixel

Como conecto o Meta ao 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

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) e o Token de acesso da Conversions API (como conseguir um). 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). Configurações avançadas é opcional (regras de pedidos).
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?

No Meta Events Manager, 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?

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ê).
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); 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 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?

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?

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.

Devo usar um código de evento de teste?

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 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?

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 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?

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 e cole-o sobre Salvo — cole um novo para substituir.
3. Clique em Continuar, depois em Salvar e continuar.

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.

Relacionados

• Acompanhe cada envio no Ao vivo
• Um remetente por pixel
• Como o cPixel conta cada compra uma única vez
• Configure a Conversions API na Shopify