Conectar o pixel da Meta

Conecte a Meta uma vez para enviar o funil que a Chargefy observa: abertura do checkout, envio dos dados de pagamento, aprovação, recusa e expiração. A configuração fica em Integrações → Meta no Dashboard.

​

Antes de começar

Tenha em mãos:

• o Pixel ID, também apresentado pela Meta como ID do conjunto de dados;
• um token de acesso da Conversions API;
• os Payment Links que devem fazer parte do alcance, se a conexão não receber todas as vendas.

O token é validado antes de a conexão ser salva. Depois disso, ele fica criptografado e não é exibido novamente; o Dashboard mostra somente os quatro últimos caracteres para conferência.

​

Criar a conexão

​

Combinar navegador e servidor

Os dois canais enviam o mesmo funil, mas cobrem situações diferentes. Mantenha o servidor ativo e use também o navegador quando sua política de privacidade e gestão de consentimento permitirem.

​

Deduplicação

Quando os dois canais enviam o mesmo evento, eles compartilham um event_id estável. A Meta usa esse identificador para tratar as duas entregas como uma única conversão; ativar ambos não deve duplicar a venda.

​

Eventos assíncronos e novas tentativas

Pix e boleto podem ser pagos depois que o comprador fecha a página. Nesses casos, somente o servidor consegue enviar o resultado. Ele também cobre a expiração da sessão e tenta novamente quando uma falha da API é temporária. Se o token for revogado, expirar ou perder permissão, a conexão é marcada como inválida e os envios param até a credencial ser substituída.

​

Segurança e leitura dos resultados

A URL que o Pixel reporta à Meta é a página hospedada do checkout, endereçada pelo id da sessão — nenhum segredo da sua conta ou da API passa por ali. Se o navegador bloquear o Pixel, o canal de navegador não inicia, mas o servidor continua funcionando.

​

Definir o alcance

Uma sessão criada diretamente pela API não possui Payment Link de origem. Por isso, ela entra no alcance amplo e fica fora de destinos restritos a links específicos. Você pode criar mais de um destino. Por exemplo, um conjunto de dados pode receber todas as vendas enquanto outro recebe apenas uma oferta. A mesma sessão pode alimentar mais de um destino quando estiver no alcance de ambos.

​

Quando o alcance é congelado

O conjunto de destinos é resolvido no momento em que a Checkout Session é criada. Depois disso, aquela sessão preserva o mesmo roteamento até concluir ou expirar. Isso mantém todos os eventos da mesma compra no mesmo conjunto de dados, mesmo quando um boleto é pago dias depois.

​

Separação entre teste e produção

Destinos pertencem ao ambiente em que foram criados. Uma conexão de teste recebe apenas sessões com livemode: false; uma conexão de produção recebe apenas sessões com livemode: true. Isso permite validar eventos sem misturar compras simuladas aos relatórios de produção.

​

Testar a conexão

Use uma Checkout Session nova para validar o caminho real de uma compra: O código de teste acompanha os envios da Conversions API. Ele não transforma o disparo do navegador em um recibo da Meta e não testa atribuição de campanha.

​

Se a qualidade não puder ser lida

Um token pode continuar autorizado a enviar eventos e, ao mesmo tempo, não permitir que a Chargefy consulte as métricas de qualidade do conjunto de dados. Nesse caso, o Dashboard mostra um aviso no destino. O aviso não significa que o envio parou. Confira o recibo em Atividade. Se também quiser acompanhar a qualidade pela Chargefy, gere outro token com permissão de leitura dessas métricas e use Substituir token.

​

Se o token deixar de funcionar

Quando a credencial é revogada, expira ou perde permissão, a conexão é marcada como inválida e os novos envios são interrompidos. Gere outro token e use a ação de substituição no destino.

​

Próximos passos