← Documentação

Primeiros passos

Do zero ao seu primeiro evento rastreado em quatro passos.

1. Crie sua conta

Cadastre-se grátis com e-mail e senha. O plano Free tem 10 mil eventos/mês, 1 site e não pede cartão.

2. Adicione seu primeiro app

Depois do cadastro, vá para o seu dashboard:

  1. Clique em Aplicações → Nova Aplicação.
  2. Dê um nome ao site (ex.: "Site institucional"), defina o fuso horário e adicione as origins permitidas (ex.: https://seudominio.com.br).
  3. Copie o site_key — você vai precisar dele no próximo passo.

3. Instale o SDK

O jeito mais fácil: cole isto no <head> do seu site, antes do </body>:

<script src="https://cdn.jsdelivr.net/npm/@racoelho/analytics@0.2/dist/index.global.js"></script>
<script>window.analytics = new Analytics.Analytics({ siteKey: 'YOUR_SITE_KEY' })</script>

Ou use o npm — veja o guia de instalação e os guias passo a passo para Next.js, React, Vue, WordPress, Shopify e outros.

4. Veja os eventos chegando

Publique o site, navegue por algumas páginas e confira o dashboard. Os primeiros eventos devem aparecer em ~30 segundos. Se nada aparecer depois de 1 minuto:

  • Confira se o site_key está correto.
  • Confira se o seu domínio está na lista de Origins Permitidas do app (CORS).
  • Abra o devtools do navegador → aba Network → filtre por "i" → procure um POST para o nosso endpoint de ingestão retornando 200.

5. Rastreie eventos próprios (opcional)

Pageviews são rastreados automaticamente. Para rastrear eventos próprios (cadastros, compras etc.):

// No navegador
window.analytics?.track('signup', { plan: 'free' })

// ou com o SDK do npm
import { Analytics } from '@racoelho/analytics'
const a = new Analytics({ siteKey: 'YOUR_SITE_KEY' })
a.purchase('order_123', 9900, 'USD')

Próximos passos

Primeiros passos · Analisa