Como rastrear vendas Pix no Meta Ads e no TikTok Ads

Para rastrear vendas Pix no Meta Ads, o evento de compra precisa sair de onde o pagamento é confirmado, e não só do navegador do cliente. O caminho é guardar o identificador do clique com o pedido, mandar o número do pedido para o gateway e, quando chegar o aviso de pagamento confirmado, enviar a compra pela API de Conversões da Meta, com deduplicação. O mesmo raciocínio vale para a Events API da TikTok e para a importação de conversões do Google Ads.

Por que a venda Pix some do gerenciador

O pixel é um código que roda no navegador e registra a compra quando a página de obrigado abre. No Pix, o caminho do cliente é outro:

1. Ele gera o Pix na sua página.
2. Copia o código e sai para o app do banco.
3. Paga lá, às vezes minutos depois.
4. Nem sempre volta para a sua página.

Se ele não volta, o evento de compra do navegador não dispara. Quem sabe que o Pix foi pago é o gateway, que avisa o seu servidor. Por isso o envio pelo servidor resolve: o evento sai de onde a confirmação chega.

O efeito na campanha é direto. Vendas que não chegam ao gerenciador inflam o CPA, derrubam o ROAS mostrado e deixam a otimização trabalhar com menos compras do que você fez. Para medir o tamanho do buraco, compare as vendas pagas do painel com as compras do gerenciador no mesmo período.

O que a NewPag oferece hoje

Hoje a NewPag não dispara pixel de anúncio por você. Ela oferece as duas peças de que o envio pelo servidor precisa: o campo external_reference, que liga cada cobrança ao seu pedido, e o webhook transaction.paid, que avisa o seu servidor quando o Pix é pago. Para isso, as cobranças precisam ser criadas pela API.

Se você vai contratar alguém para integrar, o roteiro da conversa está em integrar pagamento no site.

Passo a passo do evento de compra pelo servidor

1. Guarde o clique. Na página de destino, leia o identificador que a plataforma acrescenta ao link: fbclid no Meta, ttclid na TikTok e gclid no Google. Grave junto com as UTMs, no seu sistema.
2. Ligue o clique ao pedido. Ao criar a cobrança na NewPag (POST /api/v1/charges), envie o número do pedido em external_reference, com até 120 caracteres, e uma Idempotency-Key por pedido.
3. Espere o pagamento, não o Pix gerado. O webhook transaction.pending avisa que o Pix foi gerado. Quem avisa que a venda aconteceu é o transaction.paid. Confira a assinatura de cada aviso e ignore os que chegam com livemode: false, que são de teste.
4. Monte o evento. Encontre o pedido pelo external_reference e envie a compra com valor, moeda e o identificador do clique. A NewPag trabalha em centavos: 9700 vira 97.00 no evento.
5. Use o número do pedido como event_id. Se o pixel do navegador também registrar a compra, os dois eventos chegam com o mesmo id e a plataforma descarta a cópia.
6. Teste antes de escalar. Simule o pagamento com a chave de teste da NewPag e use as ferramentas de teste de cada plataforma para ver o evento chegar.

API de Conversões da Meta

A API de conversões é o canal pelo qual o seu servidor manda eventos para a plataforma de anúncio. Pela documentação da Meta, todo evento enviado pelo servidor precisa de event_name, event_time, user_data e action_source. Para uma venda no site:

• Evento: Purchase, o evento padrão de compra. Nele, value e currency são obrigatórios.
• Hora: event_time em segundos, no formato Unix. A Meta aceita eventos de até 7 dias atrás.
• Origem: action_source igual a website e event_source_url com o endereço da página, exigido para eventos de site.
• Dados do cliente: e-mail (em) e telefone (ph) vão com hash SHA-256. Antes do hash, o e-mail fica em minúsculas e sem espaços, e o telefone fica só com números, com o código do país. Os campos fbc, fbp, IP e navegador vão sem hash, como mostra a página de parâmetros do cliente.
• Clique: o fbc é montado a partir do fbclid, no formato fb.1.<momento em que você recebeu o fbclid, em milissegundos>.<fbclid>, conforme a página sobre fbp e fbc.
• Deduplicação: o event_id do servidor precisa ser igual ao eventID do pixel, com o mesmo nome de evento. A Meta só deduplica eventos recebidos em até 48 horas, segundo o guia de deduplicação.

Exemplo ilustrativo do evento, com valores fictícios:

{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1792944000,
    "event_id": "pedido-1234",
    "action_source": "website",
    "event_source_url": "https://sualoja.com.br/oferta",
    "user_data": {
      "em": ["<e-mail normalizado, com hash SHA-256>"],
      "ph": ["<telefone com código do país, com hash SHA-256>"],
      "fbc": "fb.1.1792943000000.<fbclid>"
    },
    "custom_data": { "value": 97.00, "currency": "BRL" }
  }]
}

Para testar, gere um test_event_code no Gerenciador de Eventos e mande junto com o evento. Tire o código antes de ir para produção.

Events API da TikTok

A central de ajuda da TikTok recomenda usar a Events API junto com o pixel. Para venda Pix:

• Evento: Purchase, o evento padrão de compra na lista de eventos da TikTok, com value e currency entre os parâmetros recomendados.
• Clique: a TikTok acrescenta o ttclid ao link do anúncio. Guarde esse valor com o pedido e envie junto com o evento, como explica a página sobre o TikTok Click ID.
• Dados do cliente: e-mail e telefone precisam ir com hash.
• Deduplicação: mande o mesmo event_id no pixel e na Events API. Pela página de deduplicação de eventos, a TikTok compara eventos iguais numa janela de 48 horas e fica com o primeiro que recebeu.
• Acesso: as chamadas da Events API usam um token de acesso.

Google Ads e Kwai Ads

Google Ads. Com a marcação automática ativa, o Google acrescenta o gclid ao link do anúncio. Grave o gclid com o pedido e, quando o Pix for pago, importe a conversão com ele. Pela central de ajuda do Google Ads, o Google guarda o GCLID por 90 dias, prazo folgado para uma venda Pix. As conversões otimizadas usam dados do cliente, como o e-mail, com hash SHA256. E, a partir de 15/06/2026, o envio de conversões offline pela Google Ads API passou para a Data Manager API, como informa a página sobre importação de conversões offline.

Kwai Ads. Confira na documentação da sua conta de anúncios como a plataforma recebe conversões enviadas pelo servidor. Do lado da NewPag, nada muda: o pedido vai em external_reference e a compra confirmada chega no transaction.paid.

Erros que distorcem o resultado

• Mandar compra no Pix gerado. Pix gerado não é venda. Quem não pagou entra na conta do Pix gerado e não pago, que pede outro tratamento.
• Enviar o valor em centavos. A NewPag usa centavos; o evento de compra usa reais.
• Usar ids diferentes no pixel e no servidor. Se os dois enviam a mesma compra sem o mesmo event_id, ela conta duas vezes e o ROAS parece maior do que é.
• Misturar teste e produção. Eventos com livemode: false e o test_event_code não devem chegar à conta real.
• Ignorar o estorno. Quando chega transaction.refunded, o dinheiro voltou ao cliente. Tire a venda do seu relatório de resultado.

Com as vendas no gerenciador, o CPA e o ROAS passam a refletir o que entrou no caixa. Para saber até quanto você pode pagar por venda, use a calculadora de ROAS. E veja como o resto da operação de anúncios se encaixa na NewPag em gateway de pagamento para tráfego pago.

Documentação das plataformas de anúncio consultada em 25/10/2026.