Pixel & Tracker

O snippet JavaScript que captura eventos no navegador do usuário e envia pro Trakd.

01 Como funciona

O pixel Trakd é um snippet JavaScript leve e assíncrono que roda no navegador do visitante. Ele cria um first-party cookie (não terceiro: sobrevive a ITP/Safari/Brave) com um identificador anônimo, observa a navegação (PageView automático) e expõe a função global trakd.track(event, params) pra eventos custom (Purchase, AddToCart, etc).

02 Instalação

Copie o snippet do painel em Pixels → detalhe do pixel → Instalar e cole antes do </head> da sua página:

index.html
<script async src="https://cdn.trakd.pro/v1/track.js"
  data-pixel="SEU_PIXEL_ID"></script>

03 Eventos automáticos

O snippet dispara automaticamente:

• PageView em todo carregamento de página
• Captura de UTMs (utm_source, utm_campaign…) e armazena na sessão
• Captura de fbclid (Facebook click ID), usado pra match com a Meta CAPI
• User-Agent + IP + hash do email se preenchido em formulários (opt-in)

04 Eventos custom

Pra disparar eventos do funil (Purchase, AddToCart, Lead, etc):

checkout.js
trakd.track('Purchase', {
  value: 197.00,
  currency: 'BRL',
  email: 'cliente@email.com',
  order_id: 'pedido-1234'
});

O Trakd hasheia automaticamente email, phone e outros dados de PII com SHA-256 antes de enviar pra Meta: o servidor recebe o hash, não o valor original.

05 Deduplicação client-vs-server

Trakd gera um event_id determinístico por evento e envia o mesmo identificador pelos dois canais (pixel client-side e CAPI server-side). A Meta deduplica automaticamente eventos que chegam com o mesmo event_id, garantindo que a venda não seja contada em dobro mesmo quando os dois canais disparam.

06 Compatibilidade

• Funciona em todos os navegadores modernos (Chrome, Safari, Firefox, Edge, Brave)
• ITP/Brave: usa first-party cookie + localStorage como fallback
• SPA-aware: hook em history.pushState pra disparar PageView em route change
• Sem dependência de cookie consent (cookie técnico, não publicitário; opt-out via DNT)