Integrar com GGCheckout

Conecte sua conta GGCheckout ao TrackCombo para rastrear vendas PIX automaticamente via webhook.

# Requisitos

• Conta ativa na GGCheckout
• Container criado no TrackCombo

# Passo a Passo

# 1. Adicione a Integração no TrackCombo

1. Abra seu container 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 container e vá em Logs
4. Verifique se o evento de venda apareceu corretamente

# Dados Rastreados

A integração envia automaticamente:

• Nome do cliente
• Email do cliente
• Telefone
• CPF/CNPJ
• 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)

# 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.

# Tracking Web (Opcional, Recomendado)

Quando o TrackCombo está instalado 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 rastreamento (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

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 o TrackCombo está instalado 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)