Pular para o conteúdo principal

Glossário

Termos que aparecem nesta doc (e em conversas com dev/BI) — definidos com a interpretação que o front-end Cactus usa, não a definição genérica de mercado quando elas divergem.

Atribuição​

Last-touch — política em que cada UTM nova sobrescreve as anteriores. O canal final que trouxe o user antes da conversão leva o crédito. É o que a Cactus usa em todas as brands desde o legado Vue.

First-touch — política oposta: o primeiro canal capturado é preservado e nunca sobrescrito. Mais comum em campanhas de awareness. Não é a política da Cactus — mudar exige alinhamento com BI (relatórios calibrados em last-touch).

Attribution window — janela de tempo entre o clique e a conversão durante a qual a atribuição ainda vale. No front, é definida pelo TTL do cookie_tracking (default 7 dias, configurável por brand via trackingCookieTtlHours).

FTD (First-Time Deposit) — primeiro depósito do usuário. Detectado por user.ftd_value === 0 ANTES do depósito, e por response do BFF DEPOIS. Dispara eventos especiais (first_deposit, pix_confirmado_ftd, AppsFlyer dep) distintos de rebill.

Rebill — qualquer depósito que não seja o primeiro. Dispara second_deposit no GTM (nome herdado do legado 7k — significa "qualquer não-FTD"), pix_confirmado no GTM, AppsFlyer rebill.

Identificadores​

external_id — UUID first-party gerado pelo front, persistido no cookie de remarketing (rmkvera, rmk7k, etc), enviado como identificador estável pra Meta CAPI / Google Enhanced Conversions / TikTok Events API. Funciona mesmo sem cookie de terceiro (iOS 14+, ITP, Brave).

ga_client_id — Google Analytics client ID, formato GA1.1.XXXXXX.YYYYYY. Lido raw do cookie _ga e enviado nos payloads de signup/deposit pro BFF.

affiliation_code — código de afiliado capturado da URL (aliases: aff, ref, referenceCode, btag, b_tag, btagid). Persistido no cookie_tracking e enviado no payload de signup. Não vai no deposit (paridade legado).

subid — sub-ID de afiliado (RedTrack, Tonic). Aliases: subid, sub_id. Capturado e enviado no payload de signup.

cinfoId / cinfoIdRef — IDs de tracking gerados pelo BFF e ecoados em headers de response (X-INFOS-ID/X-INFOS-REF) após login/register. Persistidos no cookie_referrer e enviados de volta como X-ORIGIN-CINFO-ID/X-ORIGIN-CINFO-ID-REF em todas as requests subsequentes.

appsflyer_id / advertising_id — IDs nativos do mobile (TWA), persistidos em sessionStorage. Usados só em modo app (?app=true).

Plataformas​

CAPI (Conversions API) — protocolo da Meta pra enviar eventos server-side, paralelo ao Pixel client-side. Permite atribuição mesmo com Pixel bloqueado (ad blockers, ITP). Identidade primária é o external_id. Cactus tem CAPI no roadmap (server-side via BFF) — hoje só Pixel client-side.

Enhanced Conversions — equivalente do CAPI no Google Ads. Mesma ideia: server-side com identidade enriquecida (e-mail, telefone, external_id). Roadmap.

Events API (TikTok) — equivalente da CAPI da Meta no TikTok. Roadmap.

S2S (Server-to-Server) — em qualquer plataforma, é o envio de evento direto do servidor (do BFF, no nosso caso) pra plataforma de ads, sem passar pelo browser. Mais resistente a ad blockers. AppsFlyer é o único integrado em S2S hoje (e só pra TWA).

Pixel — script client-side da plataforma de ads que dispara eventos do browser. Carregado pelo GTM ou direto pelo useAnalytics.

Tracker — termo genérico pra qualquer ferramenta de tracking (Pixel, GTM, Hotjar, Clarity, etc).

Privacidade​

GCM v2 (Google Consent Mode v2) — protocolo do Google pra propagar consent do usuário pros tags GTM. 7 sinais: analytics_storage, ad_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage, security_storage. Cada um pode ser granted ou denied. Defaults injetados no dataLayer antes do GTM carregar.

LGPD — Lei Geral de Proteção de Dados (Brasil). O banner de cookies da Cactus é compliant: 4 categorias (necessary, performance, functionality, others), opt-in/opt-out granular, persistência em cookies_consent por 12 meses.

Modo cosmético — cookieConsentCosmeticOnly: true. Banner aparece, mas qualquer clique já autoriza tudo (accept_all). Autorizado conjuntamente por marketing + compliance pra brands específicas (Vera, etc). Detalhes em Modo Cosmético.

Eventos​

Funnel signal — sinal binário e durável (registered, ftd_completed). Persiste no cookie de remarketing como audience tag.

Streaming event — sinal volumétrico (cada view_game_page, cada deposit_initiated). Vai pro dataLayer, é processado pelo GTM e disparado pros pixels. Não persiste no cookie.

view_item_list — evento GA4 ecommerce-standard que o front dispara quando uma seção da home/cassino entra no viewport pela primeira vez (após scroll). Vai pra GTM com array de itens.

view_promotion / select_promotion — eventos GA4 ecommerce de banner. Disparados quando user vê / clica em banner ou card de promoção.

Infraestrutura​

TWA (Trusted Web Activity) — APK Android que renderiza o site num WebView Chrome controlado. Comporta-se como app nativo (push, install, full screen). Dispara ?app=true na URL inicial. Detalhes em App Mode.

?app=true — query string que identifica o site rodando dentro de um TWA. Desativa todos os trackers client-side; só AppsFlyer S2S permanece ativo.

BFF (Backend-for-Frontend) — camada de API que serve o front. Endpoints em /bff/*. Recebe os payloads de signup/deposit com UTMs.

GTM (Google Tag Manager) — container que orquestra pixels client-side (Meta, Google, TikTok, Kwai, Taboola, etc) sem precisar deploy de front.

Stape (GTM Server-Side) — proxy GTM rodando em domínio próprio (ex: https://stape.brand.com). Configurado via gtmProxyUrl ou gtmScriptUrl na analyticsConfig. Permite first-party tracking parcial.

dataLayer — array global do GTM (window.dataLayer). Front faz dataLayer.push({ event: "X", ... }) e GTM dispara as tags configuradas.

brand override — arquivo em overrides/<brand>/app/config/... que substitui (file-replacement, sem deep-merge) o config default do base. É como cada brand customiza pixel IDs, GTM ID, feature flags etc.

Misc​

X-ORIGIN-* — família de headers HTTP injetados em toda chamada API pelo @cactus-agents/api-client. Carregam referrer, IDs de tracking e enum de access (1=App, 4=Mobile, etc). Usados pelo BFF pra atribuição e anti-fraude.

X-LOG-INFO — header de tracing único por request, formato 1-{timestamp}-{buildId}. Permite correlacionar logs server-side ao deploy específico.

build-id — primeiros 12 chars do commit SHA do deploy. Injetado em cookies de cache, headers de tracing, query string de scripts externos. Muda a cada deploy.

Wildcard utm_* — qualquer query param que comece com utm_ é capturado dinamicamente (não só os 4 canonical). Permite marketing adicionar utm_oferta, utm_term, utm_creative, utm_placement sem precisar deploy de front. Detalhes em UTMs.

Clicked-ID — ID de clique gerado pela plataforma de ads (gclid Google, fbclid Meta, ttclid TikTok, mgclid MGID, tclid Taboola, kwclid Kwai, obclid Outbrain, gbraid/wbraid Google iOS-15+). Capturado da URL e persistido individualmente no cookie_tracking. Detalhes em Clicked-IDs.