Carregando seu workspace…
→Voltar ao dashboard
Webhook universal
Documentação
Integração, rastreamento e configuração
Rastreamento da página de vendas
Guia completo para você instalar o rastreamento, ativar os UTMs e conectar o Pixel com a Conversions API.
1
Crie um projeto
Entre em Integrações → aba UTMs e crie um projeto informando nome e domínio da página. Cada projeto gera uma publicKey única que identifica seus eventos.
2
Instale o script de rastreamento
Copie o snippet gerado e cole antes do fechamento de </head> na sua página de vendas:
htmlGhostScale
<script async src="{SEU_DOMINIO}/tracker.js?key={SUA_PUBLIC_KEY}"></script>Ele é leve, não bloqueia o carregamento e envia os eventos por sendBeacon.
3
Ative os UTMs nos anúncios
No Parâmetros de URL do anúncio (Gerenciador de Anúncios da Meta), cole o template abaixo. A Meta preenche campanha, conjunto, anúncio e posicionamento automaticamente:
utmGhostScale
utm_source=facebook&utm_medium=paid&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_content={{ad.name}}|{{ad.id}}&utm_term={{adset.name}}|{{adset.id}}&placement={{placement}}&site_source_name={{site_source_name}}| Parâmetro | Preenchido com |
|---|---|
utm_campaign | Nome da campanha + ID |
utm_term | Nome do conjunto + ID |
utm_content | Nome do anúncio + ID |
placement | Posicionamento |
site_source_name | Facebook ou Instagram |
utm_medium | Tráfego pago |
É com esses parâmetros que a venda é atribuída à campanha certa. O
fbclid (clique do Facebook) também é capturado automaticamente quando presente.Eventos capturados
| Evento | Quando dispara |
|---|---|
| AdClick | Clique no anúncio (quando há fbclid ou utm_source na URL) |
| PageView | Carga inicial da página |
| ViewContent | Página carregada (contentName = título da página) |
| PageError | Erro de script ou rejeição capturada |
| InitiateCheckout | Clique em botão de compra (detectado automaticamente) |
| AddToCart / Lead / Purchase | Disparados manualmente com window.TrackBase.track |
Checkout (InitiateCheckout)
O script detecta automaticamente cliques em links/botões cujo texto ou URL contenha checkout, comprar, buy ou pix. Para controle fino, use o atributo:
htmlGhostScale
<button data-trackbase-event="InitiateCheckout" data-value="129.90" data-currency="BRL">
Comprar agora
</button>Compra (Purchase) — manual
Dispare no sucesso do pedido (ex.: tela de obrigado):
javascriptGhostScale
// após o pagamento ser confirmado
window.TrackBase.track("Purchase", {
value: 129.90,
currency: "BRL",
contentName: "Kit Bíblico",
contentIds: ["prod-123"]
});A compra também chega pelo webhook do gateway (approval → Purchase) com o mesmo
event_id, sem duplicar.Pixel Meta + Conversions API
1
Crie ou conecte um Pixel
Na aba Pixel & CAPI das Integrações, você pode criar um Pixel novo na Meta (informando o Business ID) ou conectar um existente (colando o Pixel ID).
2
Gere o token CAPI
No Gerenciador de Eventos da Meta, abra o Pixel da conta e gere uma chave de acesso da Conversions API (token completo). Cole-o no campo Token de acesso da Conversions API.
3
Validar e conectar
Clique em Validar e conectar Pixel + CAPI. O GhostScale valida o Pixel e o token na Meta e passa a enviar os mesmos eventos por navegador (Pixel) e servidor (CAPI) com o mesmo event_id.
Em produção real: faça upload de eventos reais por 30 dias (ou use um código de teste da Meta, ex.:
TEST12345, no campo opcional da conexão) para confirmar o recebimento.O token é guardado criptografado (AES-GCM) e usado apenas para enviar eventos ao pixel do seu projeto.
Verificando o funcionamento
Depois de instalar, acesse a página de vendas e confira:
- • O Dashboard passa a mostrar cliques, acessos, erros, inícios de checkout e compras reais.
- • A página Eventos lista PageView, ViewContent, InitiateCheckout e Purchase em tempo real.
- • Em Campanhas, o gasto da Meta é cruzado com acessos, ICs, vendas, faturamento e ROAS por campanha.
- • No teste da Meta, use um evento que você mesmo gerou e compare pelo
event_id.