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. Na edição do Payment Link, a seção Tracking permite selecionar ou remover cada Pixel individualmente. A escolha daquele link prevalece sobre o padrão da conta. Alterar o padrão do Pixel não apaga as exceções salvas nos links. 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