Pixel na PagHiper: Facebook, Google Ads e TikTok

A integração com a PagHiper envia cada PIX pago 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 em reais, ID da transação, ID do pedido, itens e os dados do pagador que a PagHiper devolve (nome, email, telefone, cidade e endereço).

A notificação da PagHiper não traz os cookies do navegador nem as UTMs. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na página onde o cliente gera o PIX e completa o evento com fbp, fbc, gclid, ttclid e UTMs antes de enviar pros pixels.

# Requisitos

• Conta ativa na PagHiper
• Projeto criado no TrackCombo
• Web Tag instalada na página onde o cliente gera o PIX, 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 PagHiper
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Token no TrackCombo

O token é necessário para que o TrackCombo consiga consultar os dados completos da transação na PagHiper.

1. Acesse o Painel PagHiper
2. Vá em Minha Conta > Dados da Conta (ou Ferramentas > Token)
3. Copie o Token exibido na página
4. Volte ao TrackCombo, na integração que você criou
5. Cole o token no campo Token nas configurações da integração
6. Clique em Salvar

# 3. Configure o Webhook na PagHiper

1. No painel da PagHiper, vá em Ferramentas > Retorno Automático (PIX)
2. Cole a URL do webhook copiada do TrackCombo no campo de URL de notificação
3. Certifique-se de que as notificações estão ativadas
4. Salve a configuração

# 4. Teste a Integração

1. Faça um pagamento PIX de teste
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 PagHiper

A PagHiper gera um único evento no Track Combo: o PIX pago (status paid), tratado como compra (purchase). Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

PIX pago na PagHiper 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

PIX 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)

PIX pago vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação, itens da cobrança e as UTMs da visita registrada pela Web Tag. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

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

# Pinterest

PIX 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

PIX 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)

PIX pago 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 cliente
• Telefone, cidade e endereço (quando informados na cobrança)
• Valor da transação (a PagHiper manda em centavos e o TrackCombo converte pra reais)
• ID da transação
• ID do pedido
• Itens da cobrança
• Método de pagamento (PIX)
• Status do pagamento

# Como Funciona

A PagHiper envia uma notificação a cada mudança de status do PIX. O TrackCombo usa essa notificação para consultar os dados completos da transação automaticamente. Por isso o token é obrigatório: sem ele, não é possível acessar as informações do pagamento.

# Problemas Comuns

Como instalar o pixel do Facebook na PagHiper?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte a PagHiper pelo token e pelo Retorno Automático (passo a passo acima). Cada PIX pago chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

A PagHiper 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 PIX pago na PagHiper é enviado como conversão. O gclid vem da visita registrada pela Web Tag.

Por que a mesma venda da PagHiper não aparece duas vezes?
A PagHiper manda mais de uma notificação pro mesmo PIX: uma quando ele é pago (paid) e outra quando a transação é concluída (completed). O Track Combo só aceita o status paid, então cada PIX vira uma única compra nos pixels. PIX gerado, pendente ou cancelado não vira venda.

Vendas não aparecem no TrackCombo?

• Verifique se o token está configurado corretamente na integração
• Confirme que a URL do webhook está correta na PagHiper
• Verifique se o retorno automático está ativado na PagHiper
• Aguarde até 5 minutos para processamento

Erro de token inválido nos logs?

• O token pode ter sido copiado incorretamente: copie novamente do painel PagHiper
• Verifique se não há espaços extras antes ou depois do token