Pixel no Mercado Pago: Facebook, Google e TikTok

A integração com o Mercado Pago envia cada pagamento aprovado (PIX, cartão 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 pagamento, itens e os dados do pagador que o Mercado Pago devolve (nome, email, telefone, CPF/CNPJ e IP).

A notificação do Mercado Pago 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 pagamento pela API, dá pra mandar esses dados direto no metadata (veja abaixo).

# Requisitos

• Conta Mercado Pago com uma aplicação criada no painel de desenvolvedores
• 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 Mercado Pago
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Access Token no TrackCombo

O Access Token é necessário para que o TrackCombo consulte os dados completos do pagamento no Mercado Pago.

1. Acesse o painel de desenvolvedores do Mercado Pago
2. Clique na aplicação que você usa no seu checkout (ou crie uma nova)
3. No menu lateral, vá em Credenciais de produção
4. Copie o Access Token
5. Volte ao TrackCombo, na integração que você criou
6. Cole no campo Access Token (produção) nas configurações da integração
7. Clique em Salvar

Use sempre a credencial de produção. Credenciais de teste não conseguem ler pagamentos reais.

# 3. Configure o Webhook no Mercado Pago

1. No painel de desenvolvedores, dentro da mesma aplicação, vá em Webhooks
2. Clique em Configurar notificações
3. Selecione a aba Modo produtivo
4. Cole a URL do webhook copiada do TrackCombo no campo de URL
5. Em Eventos, marque apenas Pagamentos
6. Clique em Salvar configuração

# 4. Teste a Integração

1. Faça um pagamento 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 após a aprovação do pagamento

# Pixels que funcionam com o Mercado Pago

O Mercado Pago gera um único evento no Track Combo: o pagamento aprovado (status approved), tratado como compra (purchase). Pagamentos pendentes, recusados, cancelados ou estornados não são enviados. Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Pagamento aprovado no Mercado Pago 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

Pagamento aprovado 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)

Pagamento aprovado vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação, itens (quando informados no pagamento) e UTMs. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

Pagamento aprovado vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.

# Pinterest

Pagamento aprovado 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

Pagamento aprovado 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)

Pagamento aprovado vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

A integração envia automaticamente:

• Nome e email do comprador (quando informados no pagamento)
• Documento do comprador (CPF/CNPJ, armazenado como hash SHA256)
• Telefone (quando informado)
• CEP e endereço (quando informados no pagamento)
• Valor e moeda da transação
• ID do pagamento
• Método de pagamento (PIX, cartão, boleto)
• Itens do pagamento (quando informados)
• IP do comprador
• UTMs, tc_code, fbp e fbc enviados no metadata do pagamento

# Melhore o match enviando metadata

Se o seu sistema cria o pagamento pela API do Mercado Pago (POST /v1/payments ou preferência do Checkout Pro), envie os dados de atribuição no campo metadata. O TrackCombo lê esses campos automaticamente e usa para cruzar a compra com a visita:

"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 email e o CPF reais do comprador no objeto payer: o Mercado Pago devolve exatamente o que você enviou, e valores fictícios impedem o match.

# Problemas Comuns

Como instalar o pixel do Facebook no Mercado Pago?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte o Mercado Pago pelo webhook e pelo Access Token (passo a passo acima). Cada pagamento aprovado chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

O Mercado Pago 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 pagamento aprovado no Mercado Pago é enviado como conversão. O gclid vem da visita registrada pela Web Tag ou do cruzamento feito com o metadata.

Por que as vendas do Mercado Pago chegam sem a campanha de origem?
O link de pagamento do Mercado Pago (mpago.la) não repassa parâmetros da URL pro pagamento. Se o seu sistema cria o pagamento pela API e manda email e CPF fictícios no payer (por exemplo 99999999999), o Track Combo não consegue ligar a venda à visita. Envie os dados reais do comprador ou o tc_code, fbp e fbc no metadata.

Vendas não aparecem no TrackCombo?

• Verifique se o Access Token de produção está configurado corretamente na integração
• Confirme que a URL do webhook foi salva no Modo produtivo (não no modo de teste)
• Verifique se o evento Pagamentos está marcado na configuração do webhook
• Aguarde até 5 minutos para processamento

Erro 401 nos logs?

• O Access Token está inválido, expirado ou é de teste. Copie novamente a credencial de produção
• Verifique se não há espaços extras antes ou depois do token

O pagamento apareceu como pendente e depois sumiu?

• Isso é esperado. Só o pagamento aprovado vira venda no TrackCombo