Pixel na Hubla: Facebook, Google Ads e TikTok

A integração com a Hubla envia cada fatura paga (vendas avulsas e cobranças de assinatura) 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 da fatura, produto, forma de pagamento e os dados do comprador (nome, email, telefone, CPF/CNPJ e endereço de cobrança).

O webhook v2 da Hubla traz as UTMs, o fbclid e os parâmetros sck, src e xcod da sessão de pagamento, mas não traz os cookies do navegador como fbp e gclid. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na sua página de vendas e completa o evento com os identificadores de clique (fbp, fbc, gclid, ttclid) antes de enviar pros pixels.

# Requisitos

• Conta de produtor na Hubla
• Projeto criado no TrackCombo
• Web Tag instalada na página de vendas, 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 Hubla
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na Hubla

O TrackCombo usa o webhook v2 da Hubla (versão atual). Configure assim:

1. Acesse o Painel da Hubla e clique em Integrações no menu lateral
2. Desça até a seção Automações e clique em Webhook
3. Abra a aba Configurações e clique em Adicionar regra
4. Em Nome, use algo como "TrackCombo"
5. Em URL, cole a URL copiada do TrackCombo
6. Em Produtos, selecione Todos os seus produtos (ou os produtos que quer traquear)
7. Em Eventos, marque Pagamento da fatura realizado (invoice.payment_succeeded)
8. Salve a regra

Esse único evento cobre vendas avulsas e assinaturas (o pagamento aprovado de qualquer fatura). Não é preciso selecionar outros eventos.

# 3. Teste a Integração

1. Faça uma compra de teste no seu produto Hubla e conclua o pagamento
2. No TrackCombo, acesse o projeto e vá na aba Eventos
3. Verifique se o evento de venda apareceu corretamente
4. Confirme que os dados (nome, email, valor, produto) foram recebidos

# Pixels que funcionam com a Hubla

A Hubla gera um único evento no Track Combo: o pagamento da fatura realizado (invoice.payment_succeeded), que vira compra (purchase). Qualquer outro evento do webhook é ignorado. Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Pagamento da fatura realizado na Hubla 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 da fatura realizado 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 da fatura realizado vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação, produto e UTMs. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

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

# Pinterest

Pagamento da fatura realizado 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 da fatura realizado 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 da fatura realizado vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

A integração envia automaticamente:

• ID da transação (ID da fatura)
• Nome, email e telefone do comprador
• Documento (CPF/CNPJ) do comprador
• Endereço de cobrança (rua, cidade, estado, CEP, país)
• Valor da compra e moeda
• Produto vendido (nome e ID)
• Método de pagamento (PIX, cartão, etc.)
• IP e navegador (User Agent) usados no pagamento
• Parâmetros de campanha (UTMs), fbclid e os parâmetros sck, src e xcod capturados no checkout

Esses dados de campanha vêm no próprio webhook v2, o que melhora a qualidade das conversões enviadas para as plataformas de anúncios.

# Dicas Importantes

• A URL do webhook é única por projeto. Não compartilhe entre projetos diferentes
• Se você alterar o projeto, será necessário atualizar a URL na Hubla
• Só o evento Pagamento da fatura realizado é processado. Faturas pendentes (pix gerado e não pago) não geram conversão, como esperado

# Problemas Comuns

Como instalar o pixel do Facebook na Hubla?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e crie a regra de webhook na Hubla (passo a passo acima). Cada fatura paga chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

A Hubla 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 fatura paga na Hubla é enviada como conversão. O gclid vem da visita registrada pela Web Tag na página de vendas.

A renovação da assinatura na Hubla também conta como compra?
Sim. O evento Pagamento da fatura realizado dispara a cada fatura paga, inclusive nas cobranças recorrentes de assinatura. Cada renovação chega nos pixels como uma nova compra, com o ID da fatura correspondente.

Vendas não aparecem no TrackCombo?

• Verifique se a URL do webhook está correta na regra da Hubla
• Confirme que o evento Pagamento da fatura realizado está marcado
• Confirme que a regra cobre o produto da venda (em Produtos)
• Aguarde até 5 minutos para o processamento

Dados incompletos?

• Verifique se o comprador preencheu todos os campos no checkout da Hubla
• Campos opcionais podem chegar vazios dependendo da configuração do produto