🔌 Integrações

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

  1. Abra seu projeto no TrackCombo
  2. Vá em Integrações
  3. Clique em + Nova Integração
  4. Selecione Pagar.me
  5. Copie a URL do webhook gerada pelo TrackCombo

2. Configure o Webhook na Pagar.me

  1. Acesse a Dashboard da Pagar.me
  2. Vá em Configurações > Webhooks
  3. Clique em Criar webhook
  4. Cole a URL copiada do TrackCombo
  5. Em eventos, marque order.paid
  6. Salve

Não é preciso configurar token: a Pagar.me já envia os dados completos do pedido.

3. Teste a Integração

  1. Faça um pedido real de teste (pode ser um PIX de valor baixo)
  2. No TrackCombo, acesse o projeto e vá na aba Eventos
  3. 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.

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.

Pinterest

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, fbp e fbc enviados no metadata do 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
pagarmepagar.meintegraçãowebhookpixpagamentopixelapi de conversõesorder.paid