Pixel na GGCheckout: Facebook, Google e TikTok

A integração com a GGCheckout 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, ID da transação, produto principal e order bumps, forma de pagamento e os dados do comprador (nome, email, telefone, CPF/CNPJ e IP).

O webhook da GGCheckout repassa as UTMs e os identificadores de clique que o checkout conseguiu capturar (fbp, fbc, gclid, ttclid), mas nem toda venda chega com eles. 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 e as UTMs que faltarem antes de enviar pros pixels.

# Requisitos

• Conta ativa na GGCheckout
• 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 GGCheckout
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na GGCheckout

1. Acesse o Painel da GGCheckout
2. Vá em Integrações > Webhooks (ou Configurações > Webhooks)
3. Clique em Adicionar webhook (ou Novo webhook)
4. Cole a URL copiada do TrackCombo no campo de URL de notificação
5. Selecione os eventos:
   • pix.paid (obrigatório, venda confirmada)
   • pix.generated (opcional, PIX gerado mas ainda não pago)
6. Salve a configuração

# 3. Teste a Integração

1. Faça uma compra PIX de teste no seu produto
2. Pague o PIX
3. No TrackCombo, acesse o projeto e vá na aba Eventos
4. Verifique se o evento de venda apareceu corretamente

# Pixels que funcionam com a GGCheckout

A GGCheckout gera um único evento de conversão no Track Combo: o PIX pago (pix.paid), que vira compra (purchase). PIX gerado e ainda não pago é descartado e não chega nos pixels. Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

PIX pago na GGCheckout 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, produtos (incluindo order bumps) e UTMs. 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 do cliente
• Email do cliente
• Telefone
• Documento do comprador (CPF/CNPJ, armazenado como hash SHA256)
• IP do comprador
• Valor da transação
• ID da transação
• Forma de pagamento (PIX)
• Status do pagamento
• Produto principal e order bumps
• UTMs (source, medium, campaign, content, term) e parâmetros src e sck
• Identificadores de clique capturados no checkout (fbp, fbc, gclid, wbraid, ttclid, ttp, epik)

# Como Funciona

A GGCheckout envia o webhook com todos os dados completos assim que o PIX é pago. O TrackCombo recebe esses dados, filtra apenas os eventos com status paid (confirmados) e cria a conversão automaticamente.

Order bumps são identificados pelo campo type=orderbump no array de produtos e ficam separados do produto principal nos itens da venda.

# Web Tag no site que leva ao checkout (Recomendado)

Quando a Web Tag do TrackCombo está instalada no site que envia tráfego para o checkout da GGCheckout (links com ggcheckout na URL), o code-event web automaticamente:

• Propaga UTMs do site para a URL do checkout
• Insere o código de traqueamento (tc_code) nos parâmetros sck ou src para amarrar o pageview com a venda
• Dispara o evento initiate_checkout quando o usuário clica no link do checkout

Isso melhora o match das conversões com a sessão de origem (UTMs, fbc, fbp, gclid, etc.) e enriquece os dados enviados para os pixels (Facebook CAPI, Google Ads, TikTok, etc.).

# Problemas Comuns

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

A GGCheckout 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 GGCheckout é enviado como conversão. O gclid vem do checkout ou da visita registrada pela Web Tag.

PIX gerado na GGCheckout conta como venda nos pixels?
Não. Só o PIX pago (status paid) vira compra. O PIX gerado (pix.generated) é recebido e descartado, então marcar esse evento no webhook não infla as vendas nos pixels.

Vendas não aparecem no TrackCombo?

• Verifique se a URL do webhook está correta na GGCheckout
• Confirme que o evento pix.paid está selecionado
• Verifique se o webhook está ativo (não em modo teste)
• Aguarde até 5 minutos para o processamento

Eventos com status BLOCKED nos logs?

• É esperado para eventos de PIX gerado mas não pago (pix.generated). O TrackCombo só processa vendas confirmadas
• Se a venda foi paga mas ficou bloqueada, abra um chamado no suporte com o ID do evento

Vendas chegando sem UTMs?

• Confirme que a Web Tag do TrackCombo está instalada no site que envia tráfego para o checkout
• Verifique se os links para o checkout contêm ggcheckout na URL (necessário para o code-event web detectar e propagar UTMs)