> ## Documentation Index
> Fetch the complete documentation index at: https://lifters.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Coloque o Atlas Web Analytics SDK rodando em 5 minutos.

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>`

<CodeGroup>
  ```html Cole no <head> de cada página theme={null}
  <!-- 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>
  ```

  ```javascript Verificação no DevTools theme={null}
  // 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?.()
  });
  ```
</CodeGroup>

<Check>
  Você deve ver na resposta: `loaded: true`, um `distinct_id` UUID e `opted_in: true`.
</Check>

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

```javascript Após autenticação bem-sucedida theme={null}
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
}
```

<Warning>
  **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.
</Warning>

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

```javascript Eventos de negócio theme={null}
// 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](https://atlas.lifters.tech) → **M8 Web Analytics**
e filtre pelo seu `organizationId`. Em alguns segundos os primeiros eventos
aparecem na aba **Realtime**.

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

## 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

<CardGroup cols={2}>
  <Card title="Instalação detalhada" icon="download" href="/sdk/web-analytics/installation">
    Hosting próprio, CDN, GTM, requisitos
  </Card>

  <Card title="Configuração" icon="gear" href="/sdk/web-analytics/configuration">
    Todos os campos do `init()`
  </Card>

  <Card title="Catálogo de eventos" icon="list" href="/sdk/web-analytics/events">
    14 eventos automáticos + custom
  </Card>

  <Card title="Privacidade & LGPD" icon="shield-halved" href="/sdk/web-analytics/privacy">
    Consent flow, masking PII
  </Card>
</CardGroup>
