Quick Start

Este guia coloca o SDK rodando no seu frontend em 4 passos. Pré-requisitos:

Credenciais Atlas (organizationId e brandId) fornecidas pela equipe
Endpoint da API Atlas (ex: https://ingest.atlas.io/v1/sdk-events)
Acesso ao código HTML do frontend ou GTM

1. Adicione o snippet no `<head>`

<!-- Atlas Web Analytics -->
<script src="https://cdn.twinfo.io/sdk.min.js" async></script>
<script>
  (function init() {
    if (!window.iGamingSDK || !window.iGamingSDK.init) {
      return setTimeout(init, 50);
    }
    window.iGamingSDK.init({
      organizationId: 'org_SEU_ID',
      brandId:        'brand_SEU_ID',
      endpoint:       'https://ingest.atlas.io/v1/sdk-events',
      respect_dnt:    true,
      property_denylist: ['password', 'cvv', 'cpf']
    });
  })();
</script>

// Cole no Console depois de carregar
console.log({
  loaded:      typeof iGamingSDK?.init === 'function',
  version:     iGamingSDK?.version,
  distinct_id: iGamingSDK?.get_distinct_id?.(),
  session_id:  iGamingSDK?.get_session_id?.(),
  opted_in:    iGamingSDK?.has_opted_in_capturing?.()
});

Você deve ver na resposta: loaded: true, um distinct_id UUID e opted_in: true.

Após autenticação bem-sucedida

function onLoginSuccess(user) {
  window.iGamingSDK.identify(user.id, {
    account_type: user.tier,         // 'vip' | 'standard'
    kyc_status:   user.kycStatus,    // 'approved' | 'pending'
    country:      user.country       // 'BR'
  });
}

function onLogout() {
  window.iGamingSDK.reset();         // rotaciona distinct_id
}

LGPD: nunca inclua em traits documentos (CPF), telefone completo, número de cartão, CVV ou senha. O operador é responsável pelo consentimento desses dados.

3. Dispare eventos custom nos pontos-chave do funil

Eventos de negócio

// Quando o usuário clica para depositar
iGamingSDK.capture('deposit.intent', {
  amount: 100,
  method: 'pix',
  source: 'casino-landing'
});

// Quando a aposta é confirmada
iGamingSDK.capture('bet.placed', {
  amount:  10,
  market:  'over-2.5',
  odds:    1.85,
  game_id: 'corinthians-vs-palmeiras'
});

// Antes de redirect crítico, força envio agora
iGamingSDK.flush();

O SDK dispara automaticamente page.viewed, session.started, scroll.depth, ig.autocapture (clicks em <button> / <a> / <form>), rage.click, dead.click, web.vitals e error.occurred. Você só precisa adicionar capture() para eventos específicos do seu negócio.

4. Valide no dashboard

Acesse Atlas Dashboard → M8 Web Analytics e filtre pelo seu organizationId. Em alguns segundos os primeiros eventos aparecem na aba Realtime.

Em dev, use iGamingSDK.flush() após cada capture() para não esperar o batch de 30s.

O que está acontecendo por baixo

[1] init() → SDK gera distinct_id, dispara session.started + page.viewed
[2] identify() → vincula distinct_id ↔ user_ext_id no SDK
[3] capture() → enfileira evento no buffer
[4] flush() ou batch=50 ou 30s → POST /v1/sdk-events
[5] events/ API → Kafka atlas.sdk-events → ClickHouse atlas.tbt_sdk_events
[6] Dashboard cruza sdk_events com tbt_raw_events_* via user_ext_id

Próximos passos

Instalação detalhada

Hosting próprio, CDN, GTM, requisitos

Configuração

Todos os campos do init()

Catálogo de eventos

14 eventos automáticos + custom

Privacidade & LGPD

Consent flow, masking PII

SDK JavaScript

Web Analytics SDK

Runbooks

1. Adicione o snippet no `<head>`

3. Dispare eventos custom nos pontos-chave do funil

4. Valide no dashboard

O que está acontecendo por baixo

Próximos passos

Instalação detalhada

Configuração

Catálogo de eventos

Privacidade & LGPD

​1. Adicione o snippet no <head>

​2. Identifique o usuário após login

​3. Dispare eventos custom nos pontos-chave do funil

​4. Valide no dashboard

​O que está acontecendo por baixo

​Próximos passos

Instalação detalhada

Configuração

Catálogo de eventos

Privacidade & LGPD

1. Adicione o snippet no `<head>`

2. Identifique o usuário após login

3. Dispare eventos custom nos pontos-chave do funil

4. Valide no dashboard

O que está acontecendo por baixo

Próximos passos