> ## Documentation Index
> Fetch the complete documentation index at: https://userin.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Instalar o Tracker
> Uma linha de código no seu site. Sem dependências, sem build. O tracker começa a capturar dados automaticamente.
## Uma linha de código para começar a capturar
Cole o script abaixo no `` do seu site e substitua `SUA_API_KEY_AQUI` pela chave que você copiou nos [Primeiros Passos](/onboarding/primeiros-passos):
```html theme={null}
```
**Recomendação:** coloque o script no `` 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:
```html theme={null}
Meu Site
```
**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**:
```html theme={null}
```
4. Salve as alterações.
**Via `functions.php`:**
```php theme={null}
function userin_tracker_script() {
echo '';
}
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`):**
```tsx theme={null}
import Script from 'next/script'
export default function RootLayout({ children }) {
return (
{children}
)
}
```
**Pages Router (`pages/_document.tsx`):**
```tsx theme={null}
import { Html, Head, Main, NextScript } from 'next/document'
export default function Document() {
return (
)
}
```
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 ``, adicione:
```html theme={null}
```
5. Salve o arquivo.
No seu `index.html`:
```html theme={null}
Minha App
```
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:
```html theme={null}
```
3. Configure o **Trigger** como **All Pages** (Todas as páginas).
4. Publique o container.
***
## O que acontece após a instalação
Assim que o script carregar, o tracker automaticamente:
Cada visitante recebe um identificador persistente salvo no `localStorage` do navegador.
Uma sessão é criada com dados de origem, URL, referrer e dispositivo.
O tracker registra a primeira página visitada com timestamp e metadados.
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.
Identifique visitantes, capture formulários e envie eventos customizados.