Debug

Como inspecionar cada surface de marketing pra investigar problema de tracking.

DevTools — onde olhar cada coisa

Cookies

Application → Cookies → seleciona o domínio.

Cookie	Pra que olhar
cookie_tracking	UTMs, clicked-IDs, affiliate code
cookie_referrer	Referrer first-touch + cinfo IDs
_ga	GA client ID
rmkvera (e outros rmk*)	UUID de remarketing
rmkvera_aud	Audience tags do funil
lastclick	Clever Advertising ID
cookies_consent	Preferências LGPD do user
_fbp, _fbc	Meta Pixel cookies

Filtrar pelo nome no campo de search da tabela. Click numa linha → painel inferior mostra "Cookie Value" + opção "Show URL-decoded" pra JSON formatado.

Network

Filtra por:

• auth/register → payload de signup
• payments/deposit → payload de deposit
• googletagmanager.com → GTM container + tags
• connect.facebook.net → Meta Pixel
• analytics.google.com → Google Analytics
• kwai.net → Kwai
• taboola.com → Taboola

Cada request tem 3 abas valiosas:

• Headers → X-ORIGIN-*, X-LOG-INFO, Authorization
• Payload → body do POST (UTMs, clicked-IDs, etc)
• Response → o que o BFF retornou (incluindo X-INFOS-ID / X-INFOS-REF)

Console

// dataLayer
window.dataLayer
window.dataLayer.filter(e => e.event === "first_deposit")
window.dataLayer.length

// Remarketing
window.__rmk
window.__rmk?.id
window.__rmk?.tags

// Meta Pixel
window.fbq
window._fbq

// Smartico
window._smartico
window._smartico_user_id

// GTM
window.google_tag_manager  // (objeto interno do GTM)

// AppsFlyer (em modo app)
window.twa  // bridge TWA

Application → Local Storage / Session Storage

Key	Conteúdo
cookie_appsflyer_id (sessionStorage)	AppsFlyer ID do device (TWA)
cookie_advertising_id (sessionStorage)	Advertising ID Android (TWA)
cookie_app_version (sessionStorage)	Versão do APK
c_documentReferrer (sessionStorage)	Referrer da sessão atual
c_documentReferrerLocal (localStorage)	Referrer first-touch ever

Extensões Chrome úteis

Extensão	Pra que serve
Meta Pixel Helper	Lista todos eventos Meta disparados em tempo real
TikTok Pixel Helper	Idem TikTok
Google Tag Assistant	Tags Google em geral (GTM, Analytics, Ads)
Adswerve dataLayer Inspector	Visualiza dataLayer events bonitinho
Cookie-Editor	Edita/remove cookies sem precisar abrir Application tab

Debug em produção

?EnableDebug=1 foi REMOVIDO do bundle de produção em maio/2026. Razão: vazamento de cookies sensíveis em response. Não há toggle visual de debug em prod.

Pra debuggar prod

1. wrangler tail (server logs)

cd repos/front-web-base
pnpm wrangler tail --env production --format pretty

Vê logs server-side em real-time (incluindo X-LOG-INFO que casa com a request do user).

2. Cloudflare Dashboard → Workers → Logs

Mesma info que wrangler tail, com filtros + histórico.

3. Cloudflare Observability → Logs (RUM)

Logs estruturados de browser side (page views, performance, etc).

4. Network tab no browser do user

Pede pro user reportando bug abrir DevTools → Network → reproduzir → exportar HAR file. Manda pro time de dev.

Reportando bug

Quando reportar bug de tracking, inclua:

• URL exata acessada
• Brand
• X-LOG-INFO da request afetada (do Network tab)
• cookie_tracking content (JSON do cookie)
• window.__rmk?.id (UUID de remarketing — facilita correlação)
• Steps to reproduce
• Screenshot do Network tab da request afetada

Cenários comuns

"Cookie não está sendo escrito"

Possíveis causas:

1. HTTP em prod — SameSite=None exige Secure. HTTP local OK (cookie escreve com Lax).
2. Browser bloqueando 3rd-party cookies — verifique Settings → Privacy → "Block third-party cookies". Em modo "block all", SameSite=None cookies não escrevem em iframes.
3. Brand sem flag ativa — remarketingId desativado pra brand → rmkvera nunca escreve.
4. Cookie name inválido — contém cactus/bluetec → front rejeita em runtime e loga warning no console.

"UTMs no cookie mas não no payload"

Possíveis causas:

1. Form submit antes do hidrate completar — TrackingCapture ainda não rodou. Caso raro, mas acontece em form submitado por click muito rápido.
2. Modal não usa o hook useTrackingParams — verificar imports do RegisterModal.tsx/DepositModal.tsx.

"Pixel não dispara"

Possíveis causas:

1. GCM v2 denied — user recusou consent. Pixel carrega mas em modo limitado.
2. disableGtm: true na brand. Verifica analytics config.
3. ?app=true — modo app desativa pixels client-side.
4. thirdPartyScriptsDisabled: true — kill switch ativo.
5. GTM container vazio — pixel não foi configurado no GTM. Operador GTM precisa adicionar a tag.

"Atribuição inflada/errada num canal"

Possíveis causas:

1. UTM em link interno — header com ?utm_source=header sobrescreve atribuição real. Auditar links internos.
2. Time janela errada — trackingCookieTtlHours muito alto, atribuição vazando entre campanhas.
3. Cap de cookie hit — utm_* custom sendo dropped. Olha tamanho do cookie vs cap de 20.

"Banner LGPD aparece sempre"

Possíveis causas:

1. cookies_consent cookie sendo limpo — pode ser extension privacy (DuckDuckGo, Privacy Badger) limpando.
2. TTL expirou — 12 meses passaram. Banner reaparece pra renovação (regra LGPD).
3. brand.features.cookieConsentPopup mudou no backoffice. Validar.

Anti-patterns

1. Tentar usar ?EnableDebug=1 em prod. Foi removido. Use wrangler tail.
2. Confiar em DevTools de dev local pra validar prod. Configs analytics são diferentes (gtmId via API muda).
3. Limpar cookies a cada teste. Atrapalha investigação de "bug que só acontece em user com X cookie pré-existente".
4. Pedir log "verbose" pra dev. Logs prod são server-side via wrangler tail — peça X-LOG-INFO da request afetada.