Marketing Docs

Bem-vindo à documentação de marketing do front-end da plataforma Cactus Gaming. Esta surface é dedicada a quem opera marketing, tráfego, CRM e BI — não é doc técnica de dev (essa vive em Internal Docs) nem de cliente que mexe no fork (essa vive em Client Docs).

Pra quem é esta doc

• Performance / tráfego pago — quer entender atribuição, UTMs, pixels, audiences e como configurar campanhas que casem com o que o front captura
• CRM / e-mail / push — precisa saber quais cookies persistem, qual identidade usar pra cross-channel, eventos disponíveis
• BI / analytics — quer mapear eventos GTM/GA4, payloads enviados pro BFF, atribuição last-touch, FTD detection
• Compliance / privacidade — precisa entender LGPD, Google Consent Mode v2, política de cookies

Aqui você não vai encontrar instruções de TypeScript, refactor de código ou design de componente — pra isso, Internal Docs.

Mapa mental

A plataforma tem 4 superfícies onde dado de marketing flui:

1. Cookies first-party — UTMs, IDs de remarketing, referrer
2. Headers HTTP — X-ORIGIN-* em toda chamada API
3. dataLayer / GTM — eventos client-side disparados pra Meta Pixel, Google, TikTok, Kwai, Taboola, Clarity, Webtrends, etc
4. Payloads do BFF — UTMs e affiliate viajam no body de signup e deposit

Cada uma é coberta em uma seção dedicada desta doc.

Resumo express dos cookies

Pra você ter o vocabulário antes de mergulhar:

Cookie	TTL	Pra quê serve
cookie_tracking	7 dias (configurável)	UTMs + clicked-ids + affiliate code (atribuição last-touch)
cookie_referrer	30 dias	Referrer externo first-touch + IDs de tracking do BFF
_ga	2 anos (Google)	Google Analytics client ID — lido raw, enviado como ga_client_id
rmkvera (e similares por brand)	365 dias sliding	UUID v4 first-party pra remarketing/CAPI
rmkvera_aud	90 dias sliding	Audience tags do funil (viewed_casino, ftd_completed, etc)
lastclick	30 dias	Clever Advertising affiliate ID
cookies_consent	12 meses	Preferências LGPD do usuário (categorias)

Detalhes completos: Storage → Cookies.

Plataformas integradas

Cada plataforma tem uma página dedicada com brand-specific setup + eventos enviados:

Categoria	Plataformas
Tag manager	GTM
Ad pixels	Facebook (Meta) · Google Ads · TikTok · Kwai · Taboola
Heatmaps / session replay	Clarity · Hotjar
A/B testing	Webtrends Optimize
Product analytics	Mixpanel · Pendo
Mobile / TWA	AppsFlyer (S2S)
Gamification + CRM	Smartico

Princípios duros que governam a captura

Todos validados em produção e documentados em Anti-patterns:

1. Atribuição é last-touch — cada UTM nova sobrescreve as antigas. Mudar isso é decisão coordenada com BI (relatórios calibrados nessa política).
2. Captura é server-side primeiro — UTMs entram no Set-Cookie da response do root loader, antes de qualquer redirect. Sobrevive a /clever, social-auth, regulatory redirects.
3. Front é "burro" — só captura, persiste e envia. Decisões de atribuição (FTD vs rebill, qualificação de affiliate, etc) acontecem no BFF.
4. Sem PII em URL — user_phone, user_email, user_name são bloqueados mesmo se a campanha tentar enviar (placeholders de TikTok ad macros costumam vazar isso).
5. Cookie names são brand-aware — rmkvera, rmk7k, rmkst77 etc. Nunca com termos de plataforma (cactus, bluetec) — o cliente final vê esse nome.

Glossário

Antes de mergulhar, dá uma olhada no Glossário se algum desses termos for novo: last-touch, first-touch, CAPI, Enhanced Conversions, external_id, GCM v2, TWA, S2S, BFF, FTD, dataLayer, clicked-id, attribution window.

Por onde começar

Você é...	Comece por...
Performance manager configurando uma campanha nova	Atribuição → Overview → Operação → Testar Campanha
Operador de GTM	Plataformas → GTM → Catálogo de eventos
Integrador de pixel novo	Por Brand pra ver onde editar
BI / analytics	Catálogo de eventos → Storage → Cookies
Compliance / DPO	Privacidade → LGPD
Time de backend	Contract BFF
Marketing tech entrando agora	Lê tudo na ordem do sidebar — começa por aqui mesmo

---

Última atualização: 2026-05. Esta doc reflete o estado atual do código em front-web-base + front-cactus-core. Mudanças no front que afetam marketing são publicadas no Changelog.