Skip to main content
Use este checklist para validar cada etapa da integração. Você precisa do DevTools do navegador aberto (F12) no seu site.

​
Checklist de verificação

1

Verificar se o tracker carregou

No Console do DevTools, digite:
__SmartTrack
Se o tracker está carregado, você verá o objeto com todos os métodos disponíveis.Se retornar undefined, o script não carregou. Verifique se:
  • O <script> está presente no HTML da página
  • A URL https://smarttrack.userin.ai/tracker.js está acessível
  • A api-key foi preenchida
  • Não há bloqueadores de anúncios interferindo
2

Verificar o ID do visitante

No console, execute:
__SmartTrack.getLocalStorageId()
Deve retornar uma string como "a1b2c3d4-e5f6-...". Esse é o identificador persistente do visitante, salvo no localStorage.
3

Verificar a sessão

Execute:
__SmartTrack.getSessionId()
Deve retornar o ID da sessão atual. Se retornar null, o tracker não conseguiu iniciar a sessão.
4

Verificar requisições de rede

Na aba Network do DevTools:
  1. Filtre por smarttrack ou tracker.
  2. Navegue pelo site normalmente.
  3. Você deve ver requisições POST sendo enviadas à API da UserIn.
Se as requisições retornam status 200, os dados estão sendo recebidos. Se retornam 401 ou 403, a API Key está incorreta.
5

Verificar na plataforma

Acesse app.userin.ai e vá para Visitantes.Você deve ver:
  • Seu visitante de teste
  • Page views registrados
  • Sessão ativa

​
Testar identificação de usuário

No console do seu site, execute: 
__SmartTrack.setExternalUserContext('teste-123', {
  email: 'teste@minhaempresa.com',
  name: 'Visitante Teste'
});
Volte à plataforma e verifique se o visitante aparece com o nome “Visitante Teste” e o email associado.
Abra uma janela anônima/privada para simular um novo visitante sem dados em cache.

​
Testar eventos customizados

Envie um evento de teste: 
__SmartTrack.customEvent('teste_integracao', {
  source: 'documentacao',
  timestamp: new Date().toISOString()
});
Esse evento deve aparecer no histórico do visitante na plataforma.

​
Problemas comuns

Causa: o script não foi carregado.Verifique:
  • O <script> está presente no HTML da página
  • A URL https://smarttrack.userin.ai/tracker.js está acessível
  • Não há erros de rede na aba Network do DevTools
  • Extensões de ad-block estão desativadas temporariamente
Causa: API Key inválida ou expirada.Verifique:
  • A api-key no script está correta
  • Copie a API Key novamente em Configurações > API Keys
  • Não há espaços extras no atributo
Causa: delay de processamento ou filtro ativo.Verifique:
  • Aguarde 1-2 minutos, alguns dados são processados em batch
  • O período selecionado no filtro de data inclui o horário atual
  • Você está no projeto correto
  • A requisição POST no Network retorna status 200
O tracker detecta mudanças de rota automaticamente via History API (pushState / popstate). Se mesmo assim não funcionar, dispare manualmente:
__SmartTrack.customEvent('pageview', {
  url: window.location.href,
  title: document.title
});
Extensões como uBlock Origin podem bloquear scripts de rastreamento.Alternativas:
  • Configure um proxy reverso no seu domínio para servir o tracker
  • Use um subdomínio próprio (ex: t.meusite.com/tracker.js)
  • Entre em contato com o suporte para configurar um domínio customizado

​
Integração completa

Se todos os checks passaram, o tracker está capturando dados e enviando para a plataforma. Agora você pode explorar os recursos da UserIn:

Ontologia de Dados

Entenda como os dados dos visitantes são organizados em campos, sinais e outputs.

Personalização com Variáveis

Use dados do perfil para personalizar modais, emails e SMS.