Configuração

Referência completa do iGamingSDK.init() — todos os campos, defaults e quando ajustar.

A função init(config) aceita um objeto com as opções abaixo. Todos os campos exceto organizationId e brandId são opcionais — os defaults são pensados para uma operação típica de iGaming.

Exemplo completo

window.iGamingSDK.init({
  // ===== Obrigatórios =====
  organizationId: 'org_SEU_ID',
  brandId:        'brand_SEU_ID',

  // ===== Endpoint =====
  endpoint: 'https://ingest.atlas.io/v1/sdk-events',

  // ===== Privacidade =====
  respect_dnt:                  true,
  opt_out_capturing_by_default: false,
  property_denylist:            ['password', 'cvv', 'cpf', 'card_number'],

  // ===== Auto-captura =====
  autocapture:         true,
  capture_pageview:    true,
  capture_pageleave:   true,
  capture_dead_clicks: true,
  capture_exceptions:  true,
  capture_performance: true,

  // ===== Heatmap =====
  heatmap: { enabled: true, sampleRate: 0.1 },

  // ===== Persistência =====
  persistence:            'localStorage+cookie',
  cookie_domain:           undefined,           // auto-detect
  cross_subdomain_cookie:  true,
  session_idle_timeout_seconds: 1800,

  // ===== URL → game mapping =====
  gameUrlPatterns: [
    { type: 'casino', pattern: '/cassino/jogo/([\\w-]+)' },
    { type: 'sport',  pattern: '/esportes/evento/([\\w-]+)' }
  ]
});

Obrigatórios

Campo	Tipo	Descrição
organizationId	string (UUID)	ID da organização Atlas. Fornecido pela equipe Atlas no onboarding.
brandId	string (UUID)	ID da marca dentro da organização. Operadores multi-brand usam um por brand.

Endpoint

Campo	Default	Descrição
endpoint	https://ingest.atlas.io/v1/sdk-events	URL completa do endpoint de ingestão. Ajuste para staging Atlas, region edge ou localhost dev.

Privacidade e LGPD

Campo	Default	Descrição
respect_dnt	true	Auto opt-out se navigator.doNotTrack === '1'
opt_out_capturing_by_default	false	Inicia em silêncio até chamar opt_in_capturing() — recomendado para fluxos com banner LGPD
property_denylist	[]	Keys removidas de toda chamada capture() antes do envio
sanitize_properties	undefined	Função custom (props, eventName) => props para sanitização avançada

Em fluxos LGPD compliant, prefira opt_out_capturing_by_default: true e chame opt_in_capturing() somente após consentimento explícito do usuário. Veja Privacidade & LGPD.

Auto-captura

Cada flag liga/desliga um collector específico. Todos ligados por padrão.

Campo	Default	O que faz
autocapture	true	Click / change / submit em <a>, <button>, <input>, <form>, <select>, <textarea>
capture_pageview	true	Pageview inicial + SPA navigation (intercepta pushState/replaceState)
capture_pageleave	true	Evento page.left antes de mudar de rota
capture_dead_clicks	true	Click sem mutação DOM em 3s
capture_exceptions	true	window.onerror + unhandledrejection
capture_performance	true	Core Web Vitals (requer lib peer web-vitals)
heatmap.enabled	true	Click XY tracking
heatmap.sampleRate	0.1	Fração de sessões amostradas (0.0–1.0). Determinístico por hash de session_id.

Persistência

Campo	Default	Descrição
persistence	'localStorage+cookie'	Modos: localStorage+cookie (default — cross-subdomain), localStorage, cookie, memory, sessionStorage
cookie_domain	auto-detect	Force para domínios com TLD composto (.com.br, .co.uk) onde auto-detection falha
cookie_name	ig_atlas_{brandId}	Prefixo do nome do cookie
cookie_expiration_days	365	Validade do cookie de identidade
secure_cookie	auto (true se HTTPS)	Flag Secure no cookie
cross_subdomain_cookie	true	Setar cookie no domínio raiz para single sign-on entre app.brand.com e m.brand.com
session_idle_timeout_seconds	1800	Inatividade que fecha a sessão e abre nova (padrão GA4/PostHog)

URL → game mapping

Campo	Tipo	Descrição
gameUrlPatterns	array	Lista de { type, pattern, extractGameId? }. Quando URL bate, o SDK adiciona game_ext_id, game_type e game_slug a todos os eventos da página.

Exemplos de patterns

gameUrlPatterns: [
  // URL: /cassino/jogo/sweet-bonanza → game_ext_id: 'sweet-bonanza'
  { type: 'casino', pattern: '/cassino/jogo/([\\w-]+)' },

  // URL: /slot/12345 → game_ext_id: 'slot-12345'
  { type: 'casino', pattern: '/slot/(\\d+)', extractGameId: 'slot-$1' },

  // URL: /esportes/futebol/evento/corinthians-vs-palmeiras
  // → game_ext_id: 'corinthians-vs-palmeiras-futebol'
  {
    type: 'sport',
    pattern: '/esportes/(\\w+)/evento/([\\w-]+)',
    extractGameId: '$2-$1'
  }
]

Use \\w em vez de \w na string JSON (escape duplo). O SDK compila as regexes uma vez no init(), custo zero por evento.

Bootstrap (avançado)

Para evitar race condition em apps com feature flags ou IDs pré-conhecidos no servidor:

window.iGamingSDK.init({
  organizationId: 'org_SEU_ID',
  brandId:        'brand_SEU_ID',

  bootstrap: {
    distinctId: 'user_already_known_id',
    isIdentified: true,
    featureFlags: {
      experiment_new_deposit_flow: 'B',
      promo_banner_v2: true
    }
  }
});

Quando bootstrap.distinctId está presente, o SDK pula a geração de UUID e usa o valor fornecido — útil quando você quer reusar o ID do seu sistema desde o primeiro pageview.

Defaults snapshot

Para garantir comportamento estável mesmo com updates do SDK:

window.iGamingSDK.init({
  organizationId: 'org_SEU_ID',
  brandId:        'brand_SEU_ID',
  defaults: '2026-04-01'   // congela o comportamento na data informada
});

Quando você não passa defaults, o SDK usa o snapshot mais recente. Operadores maduros costumam pinar uma data específica e atualizar deliberadamente.

Validação

Cole no console depois do init

console.log({
  config:   { /* não exposto — confirme via comportamento */ },
  state: {
    distinct_id: iGamingSDK.get_distinct_id(),
    session_id:  iGamingSDK.get_session_id(),
    opted_in:    iGamingSDK.has_opted_in_capturing(),
    version:     iGamingSDK.version
  }
});

Próximos passos

• Identificar usuário — chamar identify() após login
• Catálogo de eventos — eventos automáticos + custom
• Privacidade & LGPD — banner consent, masking PII