Skip to main content

​
Uma linha de código para começar a capturar

Cole o script abaixo no <head> do seu site e substitua SUA_API_KEY_AQUI pela chave que você copiou nos Primeiros Passos: 
<script
  src="https://smarttrack.userin.ai/tracker.js"
  api-key="SUA_API_KEY_AQUI"
></script>
Recomendação: coloque o script no <head> para capturar dados desde o primeiro momento do carregamento da página.

​
Instalação por plataforma

Cada stack tem suas particularidades. Encontre a sua abaixo:
Adicione diretamente no seu arquivo HTML:
<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>Meu Site</title>

  <!-- UserIn Tracker -->
  <script
    src="https://smarttrack.userin.ai/tracker.js"
    api-key="SUA_API_KEY_AQUI"
  ></script>
</head>
<body>
  <!-- Seu conteúdo -->
</body>
</html>
Via plugin (recomendado):
  1. Instale um plugin de inserção de scripts como Insert Headers and Footers ou WPCode.
  2. Vá em Configurações > Insert Headers and Footers.
  3. Cole o script no campo Scripts in Header:
<script
  src="https://smarttrack.userin.ai/tracker.js"
  api-key="SUA_API_KEY_AQUI"
></script>
  1. Salve as alterações.
Via functions.php:
function userin_tracker_script() {
  echo '<script src="https://smarttrack.userin.ai/tracker.js" api-key="SUA_API_KEY_AQUI"></script>';
}
add_action('wp_head', 'userin_tracker_script');
No seu app/layout.tsx (App Router) ou pages/_document.tsx (Pages Router):App Router (app/layout.tsx):
import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script
          src="https://smarttrack.userin.ai/tracker.js"
          strategy="afterInteractive"
          data-api-key="SUA_API_KEY_AQUI"
        />
      </head>
      <body>{children}</body>
    </html>
  )
}
Pages Router (pages/_document.tsx):
import { Html, Head, Main, NextScript } from 'next/document'

export default function Document() {
  return (
    <Html>
      <Head>
        <script
          src="https://smarttrack.userin.ai/tracker.js"
          api-key="SUA_API_KEY_AQUI"
        />
      </Head>
      <body>
        <Main />
        <NextScript />
      </body>
    </Html>
  )
}
  1. No painel Shopify, vá em Online Store > Themes.
  2. Clique em Actions > Edit Code.
  3. Abra o arquivo theme.liquid.
  4. Antes do fechamento </head>, adicione:
<!-- UserIn Tracker -->
<script
  src="https://smarttrack.userin.ai/tracker.js"
  api-key="SUA_API_KEY_AQUI"
></script>
  1. Salve o arquivo.
No seu index.html:
<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8" />
  <title>Minha App</title>

  <!-- UserIn Tracker -->
  <script
    src="https://smarttrack.userin.ai/tracker.js"
    api-key="SUA_API_KEY_AQUI"
  ></script>
</head>
<body>
  <div id="root"></div>
  <script type="module" src="/src/main.tsx"></script>
</body>
</html>
O tracker detecta automaticamente mudanças de rota em SPAs (React, Vue, Angular), capturando page views mesmo sem recarregamento de página.
  1. No GTM, crie uma nova Tag do tipo HTML Personalizado.
  2. Cole o seguinte código:
<script
  src="https://smarttrack.userin.ai/tracker.js"
  api-key="SUA_API_KEY_AQUI"
></script>
  1. Configure o Trigger como All Pages (Todas as páginas).
  2. Publique o container.

​
O que acontece após a instalação

Assim que o script carregar, o tracker automaticamente:
1

Gera um ID único para o visitante

Cada visitante recebe um identificador persistente salvo no localStorage do navegador.
2

Inicia uma sessão

Uma sessão é criada com dados de origem, URL, referrer e dispositivo.
3

Captura o primeiro page view

O tracker registra a primeira página visitada com timestamp e metadados.
4

Começa a escutar interações

Cliques, scrolls, formulários e mudanças de visibilidade passam a ser monitorados automaticamente.
Nenhuma configuração adicional é necessária para a captura básica de dados. O tracker funciona imediatamente após a instalação.
Teste rápido: abra o console do navegador (F12) e digite __SmartTrack. Se o objeto aparecer com os métodos disponíveis, a instalação está correta. Se retornar undefined, revise se o script está carregando na página.

​
Próximo passo

O tracker já está capturando dados anônimos. Agora, conecte esses dados a usuários reais do seu sistema.

Conectando Dados

Identifique visitantes, capture formulários e envie eventos customizados.