Proxy first-party (adblock)

Como servir o script e o endpoint de eventos pelo SEU domínio, evitando bloqueio por adblockers.

01 Por que fazer isso

Por padrão o snippet carrega de cdn.trakd.pro e envia eventos pra api.trakd.pro/v1/track. Alguns adblockers (uBlock, AdGuard, Brave agressivo) bloqueiam requests pra domínios de tracking de terceiros e paths como /track. Resultado: parte dos seus visitantes some das métricas. Servindo o script e o endpoint pelo seu próprio domínio (proxy first-party), o request fica indistinguível do tráfego normal do seu site.

02 Como funciona (data-api)

O tracker já suporta override do endpoint via atributo data-api. Você cria duas rotas no seu domínio que fazem proxy pros nossos servidores e aponta o snippet pra elas:

index.html
<script async src="/t/track.js"
  data-pixel="SEU_PIXEL_ID"
  data-api="/t/v1/track"></script>

Onde /t/track.js serve o bundle e /t/v1/track repassa os eventos. O prefixo /t/é sugestão: qualquer path neutro funciona (evite conter "track", "pixel" ou "analytics" no path se quiser máxima resiliência: no exemplo mantivemos /t/v1/track pela clareza).

03 Exemplo · Next.js

next.config.js
module.exports = {
  async rewrites() {
    return [
      {
        source: '/t/track.js',
        destination: 'https://cdn.trakd.pro/v1/track.js',
      },
      {
        source: '/t/v1/track',
        destination: 'https://api.trakd.pro/v1/track',
      },
    ];
  },
};

Rewrites do Next.js preservam método e body do POST: nenhuma configuração extra. O IP do visitante chega pra gente via headers x-forwarded-for que a Vercel/host já injeta.

04 Exemplo · nginx

nginx.conf
location = /t/track.js {
  proxy_pass https://cdn.trakd.pro/v1/track.js;
  proxy_set_header Host cdn.trakd.pro;
  proxy_ssl_server_name on;
}

location = /t/v1/track {
  proxy_pass https://api.trakd.pro/v1/track;
  proxy_set_header Host api.trakd.pro;
  proxy_ssl_server_name on;
  # IMPORTANTE: repassa o IP real do visitante (geo + match quality na Meta)
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

O header X-Forwarded-For é obrigatório no proxy do endpoint: sem ele todos os eventos chegam com o IP do SEU servidor, degradando a geolocalização e o match quality dos eventos na Meta.

05 Checklist de validação

Depois de configurar, valide:

• https://seusite.com/t/track.js responde 200 com o bundle JavaScript.
• Com o site aberto, o console NÃO mostra erros [trakd] (o tracker loga rejeições como pixel_not_found no primeiro evento).
• No painel do Trakd, os eventos PageView aparecem com o seu pixel: inclusive num browser com uBlock Origin ativo.

06 Não rode o Meta Pixel junto

Se você já está usando o Trakd, não instale o Meta Pixel próprio em paralelo. O Trakd envia conversões server-side pra Meta via CAPI: rodar o Pixel do lado do cliente junto criaria duplicação. Resultado: conversões aparecem 2 vezes no seu Ads Manager, inflando métricas e prejudicando o aprendizado do algoritmo.

Remova o <script> do Meta Pixel do seu site. O Trakd cuida de enviar tudo.