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, Floodlight, Pendo, etc. Em algumas brands existe um segundo container lendo de um dataLayer próprio (anaLayer) — ver anaLayer
4. Payloads do BFF — UTMs e affiliate viajam no body de signup e deposit

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

Brands cobertas

Esta doc cobre as brands do front-web-base — 13 hoje; a lista viva é o diretório overrides/:

7k-bet-br, betpontobet-bet-br, casateste-com, cl-bet7k-com, donald-bet-br, fi-7k-bet, ng-7k-bet, pb-bet, ph-state77-com, pt-state77-com, rj-bet, state77-com, x2b-bet.

:::caution vera.bet.br e cassino.bet.br saíram do base As duas foram removidas do front-web-base em 2026-07 e não têm mais override nem ambiente de deploy — fora do escopo desta doc. Config, cookies (rmkvera) e exemplos dessas brands não existem mais neste repo. Onde você encontrar referência a elas em doc antiga, trate como histórico. :::

Cada brand configura pixels, GTM, cookies e flags no seu próprio overrides/<brand>/ — ver Por Brand → Config Map.

Resumo express dos cookies

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

Cookie	TTL	Pra quê serve
cookie_tracking	30 dias (720h) por default, configurável por brand	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
<rmkCookie> (ex. rmk7k)	365 dias sliding	UUID v4 first-party pra remarketing/CAPI
<rmkCookie>_aud (ex. rmk7k_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 de consent do usuário (categorias)

:::danger A janela de atribuição é 30 dias, não 7 TRACKING_COOKIE_DEFAULT_MAX_AGE é 30 * 24 * 60 * 60 e o base não define trackingCookieTtlHours, então toda brand sem override herda 720 horas / 30 dias. Doc anterior dizia 7 dias (168h) — isso é a janela contra a qual marketing planeja campanha, então vale conferir os relatórios calibrados no número antigo.

Overrides por brand hoje: 7k-bet-br 720h, betpontobet-bet-br 240h, donald-bet-br 240h. As demais herdam 720h. Detalhes em UTMs. :::

Detalhes completos: Storage → Cookies.

Plataformas integradas

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

Categoria	Plataformas
Tag manager	GTM · anaLayer (GTM secundário)
Ad pixels	Facebook (Meta) · Google Ads · Floodlight / DV360 · TikTok · Kwai · Taboola
Heatmaps / session replay	Clarity · Hotjar — os dois desligados hoje
A/B testing	Webtrends Optimize — nenhuma brand ativa hoje
Product analytics	Pendo
Mobile / TWA	AppsFlyer (S2S)
Gamification + CRM	Smartico

Mixpanel foi removido de todas as brands em 2026-05 e não existe mais no código — não há hook, config, package nem canal na matriz de destinos. Se você encontrar referência a Mixpanel em doc, dashboard ou tracking spec antigos, está desatualizada.

Os canais de destino que a matriz de eventos realmente declara (11 hoje) estão em Catálogo de eventos — inclusive os que não têm página própria porque não têm SDK no front (audience_cookie, bff_capi).

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 — rmk7k, rmkst77, rmkbpb, rmkdnb etc, um por brand. Nunca com termos de plataforma (cactus, bluetec) — o cliente final vê esse nome, e o front rejeita em runtime nomes que contenham esses termos.

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, anaLayer, Floodlight, clicked-id, attribution window, marketingScriptsStrategy, enabledSpecificEvents.

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 → anaLayer → Catálogo de eventos. Confira em qual container a brand está antes de debuggar — na 7k o GTM primário está desligado
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

---

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