Voltar para documentação
Recursos

SynchroPixel

Snippet de captura no checkout, janela de pareamento de 7 dias e como o servidor casa visita com webhook de venda para enriquecer eventos do CAPI.

Disponível no seu workspace: capture os parâmetros de atribuição (fbclid, gclid, ttclid, _fbp, _fbc) que os webhooks de plataforma não trazem, garantindo que seu CAPI envie eventos com origem completa para Meta, Google e TikTok.

Visão geral

Quando uma venda acontece na Hotmart, Kiwify, Eduzz, Braip ou Asaas, o webhook que chega ao Synchro contém os dados financeiros e do comprador — mas não inclui os parâmetros de atribuição que a Meta, Google e TikTok precisam para casar a venda com o anúncio que a originou:

  • fbclid — clique vindo de anúncio Meta.
  • gclid — clique vindo de anúncio Google.
  • ttclid — clique vindo de anúncio TikTok.
  • _fbp / _fbc — cookies de browser fingerprint da Meta.

Sem isso, o CAPI envia eventos “anônimos” — o ad network sabe que houve uma compra, mas não sabe qual clique levou a ela. A IA de otimização perde a metade mais importante do sinal.

O SynchroPixel resolve isso colocando uma camada de captura no seu próprio checkout (página de venda, página de obrigado, ou qualquer ponto que você quiser instrumentar). O snippet JavaScript:

  1. Lê os parâmetros de atribuição da URL e dos cookies do navegador.
  2. Envia esses dados para o servidor do Synchro Hub.
  3. Quando a venda chega via webhook, o Synchro casa automaticamente venda + atribuição (janela de 7 dias).
  4. O CAPI passa a enviar eventos completos — venda + clique de origem — para os ad networks.

Tela de configuração do SynchroPixel (preview)

Por que existe

Os webhooks das plataformas de checkout (Hotmart, Kiwify etc.) foram desenhados antes do CAPI ser uma necessidade prática. Eles enviam dados de transação (preço, comprador, status), mas não os identificadores de atribuição publicitária. As plataformas não têm planos públicos de adicionar — algumas oferecem campos customizados, mas nenhuma garante captura confiável dos cinco parâmetros que importam.

A indústria adotou pixels próprios (Facebook Pixel, Google Tag, TikTok Pixel) — cada um disparando do navegador, dependendo de cookies, sujeito a bloqueios. O SynchroPixel não substitui esses pixels: complementa, garantindo que o servidor do Synchro também tenha os dados de atribuição quando montar o evento CAPI.

Como funciona

1. Instalação do snippet

Em Configurações → Integrações → Synchro Pixel, você gera sua chave de API. O snippet aparece pronto para colar:

<script async src="https://connect.synchrohub.com.br/v1/pixel/synchro-pixel.js?k=px_live_..."></script>

Cole no <head> das páginas que quiser instrumentar (checkout, obrigado, landing). Carregamento assíncrono, ~2KB — não afeta tempo de carregamento.

2. Captura no browser

O snippet, ao carregar:

  • Lê fbclid, gclid, ttclid da URL.
  • Lê _fbp e _fbc dos cookies (se existirem).
  • Envia tudo (junto com URL referrer e timestamp) para o endpoint do Synchro.

3. Match servidor-side

Quando o webhook de venda chega, o Synchro busca, na tabela de visitas dos últimos 7 dias, registros que batem com:

  • E-mail do comprador.
  • Sessão do navegador (cookie _synchro_visit).
  • IP + User Agent (heurística de fallback).

O melhor match vira a atribuição da venda.

4. CAPI completo

Eventos enviados via CAPI incluem os parâmetros de atribuição. A IA do ad network recebe sinal completo.

Domínio personalizado para o pixel

Por padrão, o snippet aponta para connect.synchrohub.com.br. Você pode trocar para um subdomínio seu — por exemplo pixel.suaempresa.com — em Configurações → Domínio Personalizado.

Por que isso importa

  • Bloqueadores de anúncio e tracker são mais agressivos com domínios “de terceiros”. Listas como EasyPrivacy/uBlock bloqueiam dezenas de domínios conhecidos de tracking; um subdomínio do seu próprio site não está nessas listas. Resultado prático: mais eventos chegam ao Synchro, mais matches, atribuição mais precisa.
  • Same-origin no navegador do seu cliente final. O DevTools mostra apenas o seu domínio — nenhuma referência a synchrohub.com.br aparece para o usuário do seu checkout.
  • Cookies first-party. Identificadores de sessão ficam sob o seu domínio, o que os torna mais persistentes (Safari ITP, Firefox ETP e similares aplicam regras mais permissivas a cookies first-party).
  • Sua marca, ponta a ponta. O snippet entregue ao cliente final mostra https://pixel.suaempresa.com/... em vez de um domínio do Synchro.

Como configurar (resumo)

  1. Em Configurações → Domínio Personalizado, informe o subdomínio que você quer usar (ex.: pixel.suaempresa.com).
  2. Crie um registro CNAME no painel DNS do seu provedor (Registro.br, GoDaddy, etc.) apontando para o destino que mostramos na tela.
  3. Aguarde — em geral leva poucos minutos. Verificamos a cada 30 segundos e emitimos o certificado SSL automaticamente assim que a propagação termina.
  4. Pronto. A página do snippet em Configurações → Integrações → Synchro Pixel passa a mostrar o snippet já com o seu domínio. Cole no seu site e pronto.

Domínio raiz (ex.: suaempresa.com sem prefixo) não é suportado — use sempre um subdomínio.

O que acontece quando o certificado fica pronto

  • O snippet exibido na tela do pixel é atualizado automaticamente para usar https://pixel.suaempresa.com/....
  • Todas as chamadas que o pixel faz (captura de visita, identificação) passam pelo seu domínio — incluindo a URL interna que o JavaScript usa para enviar dados ao Synchro.
  • Snippets que você já tinha colado com o domínio padrão continuam funcionando normalmente — não há nada para refazer no seu site se você não quiser. Mas, idealmente, atualize o snippet para que todo o tráfego do pixel passe pelo seu domínio.

Você pode desativar a qualquer momento

A qualquer momento você pode remover o domínio personalizado em Configurações → Domínio Personalizado → Remover hostname. Importante: ao remover:

  • O Synchro deixa de responder no seu subdomínio. Qualquer snippet ou link que esteja apontando para pixel.suaempresa.com deixa de funcionar imediatamente.
  • Você precisa, antes de remover, trocar os snippets já instalados pelo snippet com o domínio padrão (connect.synchrohub.com.br) — caso contrário, os pixels nas suas páginas vão começar a falhar silenciosamente e você vai perder atribuição até corrigir.
  • O certificado SSL emitido é revogado, e o subdomínio pode ser reivindicado por outra conta no futuro.

A operação é reversível — você pode reativar o mesmo subdomínio depois — mas planeje a janela de troca com cuidado se já estiver em produção.

Múltiplos domínios na mesma conta de pagamento

Se a sua conta de pagamento administra vários workspaces (modelo agência), você pode usar subdomínios diferentes em workspaces diferentes da mesma raiz: pixel.empresaA.com no workspace 1, checkout.empresaA.com no workspace 2. O Synchro respeita essa hierarquia automaticamente.

O que não é permitido: um subdomínio de uma conta de pagamento ser reivindicado por outra conta. Isso bloqueia takeover entre clientes.

Resiliência

A infraestrutura tem várias camadas de durabilidade:

  • Persistência primária em banco — toda visita é gravada antes de qualquer cache. Nada vive só em memória.
  • Cache de match com janela de 7 dias — pareamento rápido em tempo real; se o cache falhar, o sistema cai automaticamente no banco sem perder evento.
  • Fila com reentrega automática — se o envio para o ad network falhar (rede, indisponibilidade do ad network), o evento é republicado em até 1 minuto. Eventos não somem.

Pré-requisitos

  • CAPI já habilitado para pelo menos uma conta de anúncios.
  • Acesso ao código (ou ao gerenciador de tags) do seu checkout para colar o snippet.
  • Política de privacidade atualizada mencionando captura de parâmetros de atribuição (recomendado para LGPD).
  • Opcional: acesso ao painel DNS do seu domínio, caso queira usar um subdomínio personalizado.

Disponibilidade

Disponível para todos os workspaces com CAPI ativo. Configure o snippet em Configurações → Integrações → Synchro Pixel e, se quiser, o subdomínio próprio em Configurações → Domínio Personalizado.

API JavaScript (window.synchroPixel)

O snippet expõe uma única global. Use no seu checkout para anexar a sessão de pixel ao pagamento criado em Stripe, Asaas ou outros gateways — sem isso, PIX e Boleto perdem atribuição (o navegador do cliente já não existe quando o webhook chega).

// Sempre disponível depois que o snippet carregou
window.synchroPixel.getSessionId();
// → "550e8400-e29b-41d4-a716-446655440000"

window.synchroPixel.getCheckoutMetadata();
// → { synchroSessionId: "...", fbclid: "...", gclid: "...", utmSource: "google", ... }
// Apenas chaves não-vazias são retornadas.

Quando usar: no clique de “Pagar” do seu checkout, antes de chamar a API do gateway. Veja exemplos prontos na seção “Atribuição de ROI em PIX/Boleto” das integrações de Stripe e Asaas.

Fallback: se o usuário bloqueou o snippet por AdBlocker, window.synchroPixel fica undefined. Trate com ?.:

const meta = window.synchroPixel?.getCheckoutMetadata() ?? {};

Perguntas frequentes

Como ativo no meu workspace? No app, vá em Integrações → SynchroPixel, copie o snippet gerado com sua chave de API e cole no checkout, página de obrigado ou header do site. Se precisar de ajuda na instalação, fale com o suporte.

Funciona com checkout transparente (no meu domínio)? Sim — esse é o cenário ideal, pois o pixel roda no mesmo domínio da venda e captura tudo sem cross-site. Combinado com domínio personalizado, é a configuração com a melhor taxa de captura possível.

Preciso usar domínio personalizado? Não. O snippet padrão funciona perfeitamente. O subdomínio personalizado é um upgrade opcional para fugir de bloqueadores e ganhar same-origin — quem trabalha com tráfego pago em escala costuma ver diferença significativa no volume de matches.

Posso trocar de subdomínio depois? Pode. O processo é remover o atual + reivindicar o novo. Tenha cuidado com snippets já em produção — atualize-os antes de remover o domínio atual, ou eles param de funcionar até serem trocados.

Funciona com checkout hospedado na plataforma (ex.: pay.hotmart.com)? Funciona, mas a janela de match é menor — colando o snippet só na sua landing page você captura o clique de entrada; o checkout em outro domínio não é instrumentado. Mesmo assim, o match por e-mail + IP + User Agent costuma resolver a maioria das vendas.

E LGPD / consentimento? Os parâmetros capturados (fbclid, gclid, ttclid, cookies _fb*) são identificadores publicitários. Boa prática: mencionar o tratamento na sua política de privacidade. O Synchro não armazena dados em claro além do necessário e respeita o ciclo de purge da LGPD.

Substitui o Facebook Pixel / Google Tag / TikTok Pixel? Não. Mantenha os pixels do navegador também — o ad network deduplica entre os dois caminhos. Ter pixel + SynchroPixel + CAPI é o setup mais robusto.

Por que isso depende do Synchro existir? Você poderia construir uma camada parecida sozinho — endpoint de captura, banco, match logic, servidor CAPI. Estimamos algumas semanas de engenharia. O SynchroPixel entrega tudo plug-and-play, integrado ao mesmo workspace que já tem suas vendas e suas integrações de anúncio.