Pixel na Pagar.me: Facebook, Google Ads e TikTok
Envie cada pedido pago da Pagar.me pro Facebook, Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI pela API de Conversões, server-side.
A integração com a Pagar.me envia cada pedido pago (order.paid, em cartão, PIX ou boleto) pros pixels do Facebook (Meta), Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI, pela API de Conversões de cada plataforma (server-side). A venda vai como evento de compra com valor, moeda, ID do pedido, itens e os dados do comprador (nome, email, telefone, CPF/CNPJ e endereço).
O webhook da Pagar.me não traz os cookies do navegador. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na página onde o cliente inicia o pagamento e completa o evento com fbp, fbc, gclid, ttclid e UTMs antes de enviar pros pixels. Se o seu sistema cria o pedido pela API, dá pra mandar esses dados direto no metadata (veja abaixo).
Requisitos
- Conta ativa na Pagar.me
- Projeto criado no TrackCombo
- Web Tag instalada na página onde o cliente inicia o pagamento, pra venda ser ligada ao clique no anúncio
- Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa
Passo a Passo
1. Adicione a Integração no TrackCombo
- Abra seu projeto no TrackCombo
- Vá em Integrações
- Clique em + Nova Integração
- Selecione Pagar.me
- Copie a URL do webhook gerada pelo TrackCombo
2. Configure o Webhook na Pagar.me
- Acesse a Dashboard da Pagar.me
- Vá em Configurações > Webhooks
- Clique em Criar webhook
- Cole a URL copiada do TrackCombo
- Em eventos, marque order.paid
- Salve
Não é preciso configurar token: a Pagar.me já envia os dados completos do pedido.
3. Teste a Integração
- Faça um pedido real de teste (pode ser um PIX de valor baixo)
- No TrackCombo, acesse o projeto e vá na aba Eventos
- Verifique se o evento de venda apareceu corretamente
Pixels que funcionam com a Pagar.me
A Pagar.me gera um único evento no Track Combo: o pedido pago (order.paid com status paid), tratado como compra (purchase). Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.
Facebook (Meta)
Pedido pago na Pagar.me vira Purchase na API de Conversões, com valor, moeda, ID da transação e dados do comprador. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.
Google Ads
Pedido pago vira a conversão de compra do Google Ads. O envio usa o Conversion Label que você cadastra no pixel pro evento purchase; sem label, a venda não é enviada. Veja como configurar o pixel do Google Ads.
GA4 (Google Analytics)
Pedido pago vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação, itens do pedido e UTMs. Precisa do API Secret no pixel. Veja como configurar o GA4.
TikTok
Pedido pago vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.
Pedido pago vira checkout, o evento de compra da API de Conversões do Pinterest. Precisa do token no pixel. Veja como configurar o pixel do Pinterest.
Taboola
Pedido pago vira make_purchase. Só vão pro Taboola as vendas de quem chegou por um anúncio do Taboola (com o clique tbclid registrado pela Web Tag). Veja como configurar o pixel do Taboola.
OpenAI (anúncios no ChatGPT)
Pedido pago vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.
Dados Traqueados
A integração envia automaticamente:
- Nome, email e telefone do comprador
- Documento do comprador (CPF/CNPJ, armazenado como hash SHA256)
- Gênero e data de nascimento (quando informados)
- Endereço (país, estado, cidade, CEP e rua)
- Valor e moeda do pedido
- ID e código do pedido
- Método de pagamento (cartão, PIX, boleto)
- Itens do pedido
- IP do comprador (quando enviado na criação do pedido)
- UTMs,
tc_code,fbpefbcenviados nometadatado pedido
Melhore o match enviando metadata
Se o seu sistema cria o pedido pela API da Pagar.me (POST /core/v5/orders), envie os dados de atribuição no campo metadata:
"metadata": {
"tc_code": "tc_12345678",
"fbp": "fb.1.1700000000000.123456789",
"fbc": "fb.1.1700000000000.AbCdEf",
"utm_source": "ig",
"utm_medium": "paid_social",
"utm_campaign": "minha-campanha"
}
O tc_code fica em window.tcData.tc_code; o fbp e o fbc são os cookies _fbp e _fbc do navegador do comprador. Envie também o campo ip do comprador ao criar o pedido.
Problemas Comuns
Como instalar o pixel do Facebook na Pagar.me?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte a Pagar.me pelo webhook order.paid (passo a passo acima). Cada pedido pago chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.
A Pagar.me envia conversões pro Google Ads?
Sim. Com a integração ativa e o pixel do Google Ads cadastrado com o Conversion Label de compra, cada pedido pago na Pagar.me é enviado como conversão. O gclid vem da visita registrada pela Web Tag.
Por que usar order.paid e não charge.paid?
Um pedido da Pagar.me pode ter mais de uma cobrança (charge). A integração só aceita order.paid pra cada pedido virar uma única compra nos pixels, sem venda duplicada.
Vendas não aparecem no TrackCombo?
- Verifique se o webhook está ativo na Pagar.me
- Confirme que a URL está correta
- Verifique se o evento order.paid está marcado
- Aguarde até 5 minutos para processamento
O pedido foi criado mas não virou venda?
- Isso é esperado. Só pedidos pagos viram venda no TrackCombo