O pixel de conversão roda no navegador e pode perder eventos: o cliente fecha a página antes de o evento sair, ou o navegador bloqueia o código. A API de conversões envia o mesmo tipo de evento a partir do servidor, que sabe com certeza se a venda foi paga.
O que dizem as plataformas
| Plataforma | Nome | Recomendação da documentação |
|---|---|---|
| Meta | Conversions API | Usar a API junto com o Meta Pixel, com deduplicação |
| TikTok | Events API | Configurar a API como um segundo canal, junto com o Pixel do TikTok |
Como funciona com o Pix
- O cliente chega pelo anúncio, e o seu site cria o pedido e guarda os dados da visita.
- O seu sistema gera a cobrança Pix com o número do pedido.
- O cliente paga no app do banco.
- O gateway avisa o seu servidor que o pagamento foi confirmado.
- O servidor envia o evento de compra, com o valor e a moeda, para a plataforma.
Assim, só vendas pagas viram compra no gerenciador, mesmo que o cliente nunca volte para a sua página.
Pixel e API juntos
Quando a mesma compra chega pelo navegador e pelo servidor, a plataforma precisa saber que é um evento só. Na Meta, isso se chama deduplicação: os dois envios usam o mesmo nome de evento e o mesmo identificador. Sem isso, a mesma venda pode ser contada duas vezes e o ROAS fica maior do que é.
Na NewPag
Na NewPag, a integração usa a API. Ao criar a cobrança, você envia o número do pedido no campo external_reference. Quando o Pix é pago, o webhook transaction.paid chega com esse mesmo número e o valor, e o seu servidor envia a compra para a plataforma. O webhook transaction.refunded avisa quando uma venda foi estornada, para você corrigir os seus relatórios.
Quem vende só por link de pagamento, sem integração, ainda não tem pixel no checkout da NewPag. Nesse caso, um link por campanha ajuda a separar as vendas no painel.
Em linguagem simples, o caminho está em integrações. Para a operação completa, veja gateway de pagamento para tráfego pago.
Termos relacionados
Perguntas frequentes
Preciso de programador para usar a API de conversões?
Em geral, sim, ou de uma ferramenta que faça essa ligação. É preciso receber o aviso de pagamento, achar o pedido e enviar o evento no formato que a plataforma de anúncio pede.
Se eu usar o pixel e a API juntos, a venda conta duas vezes?
Não, se você configurar a deduplicação. Na Meta, o evento do pixel e o do servidor precisam ter o mesmo nome e o mesmo identificador de evento: eventID no pixel e event_id na API.