# Instalar o pixel

O pixel é um pequeno código que você instala no seu site. Ele registra as visitas e de onde cada uma veio, para que o LeadStalker ligue seus leads e vendas às campanhas e anúncios que os trouxeram.

## O que ele faz

- Registra as páginas visitadas, inclusive em sites de página única (React, Vue, Next.js…).
- Guarda a origem de cada visita: UTMs, site de referência e os identificadores de clique do Google, Meta, TikTok e Microsoft Ads.
- Reconhece o mesmo visitante quando ele volta, com um identificador anônimo salvo no próprio site.
- Carrega de forma assíncrona, sem deixar o site mais lento, e nunca lê o que é digitado nos formulários.

## Gerar o código

1. No app, abra **Configurações do negócio → Pixel**.
2. Informe a URL do site e clique em **Gerar pixel**.

Cada site tem o seu código: ele só funciona no domínio informado e nos subdomínios dele. Gerar de novo para o mesmo site devolve sempre o mesmo código.

O código tem este formato:

```html
<!-- LeadStalker Pixel -->
<script>window.lsq=window.lsq||[];function ls(){lsq.push(arguments)}</script>
<script async src="https://dash.leadstalker.app/track.js" data-ls-pixel="SEU_TOKEN"></script>
```

::: tip O código é público
Ele fica visível no HTML do site e não dá acesso nenhum à sua conta.
:::

## Onde colar

Cole antes de `</head>` em **todas** as páginas do site — inclusive landing pages, checkout e página de obrigado — e publique.

Regras que valem em qualquer site:

- São duas tags `<script>`: mantenha as duas, nessa ordem. A primeira cria a função `ls()`, que o site pode usar antes do pixel terminar de carregar.
- Não altere, minifique nem remova atributos: `data-ls-pixel` é obrigatório, e o `async` deve ser mantido.
- Carregue o código uma única vez por página.

### Sites de página única

Em React, Vue, Next.js e parecidos, coloque o código no layout ou template raiz, nunca dentro de componentes de página. O pixel detecta as mudanças de rota sozinho.

### Next.js

Use dois componentes `<Script>` de `next/script` com `strategy="afterInteractive"`, na mesma ordem: o primeiro com `id="leadstalker-queue"` e o código da primeira tag como conteúdo; o segundo com os mesmos atributos da segunda tag.

### WordPress

Use o hook `wp_head` ou o campo de scripts do cabeçalho do tema ou do construtor de páginas.

### Google Tag Manager

Crie uma tag de **HTML personalizado** com o código, disparando em todas as páginas.

## Content Security Policy

Se o site usa Content Security Policy, libere a origem do script em `script-src` e a origem da coleta em `connect-src`. A aba **Pixel** do app mostra os dois endereços exatos no prompt de instalação com IA.

## Instalar com um assistente de IA

Usa um assistente que edita o código do site (ChatGPT, Claude, Cursor, Lovable…)? A aba **Pixel** tem um botão **Copiar prompt** com o código e todas as regras acima, já com o seu domínio. Cole no assistente.

## Conferir

Abra o site em outra aba e veja a visita aparecer em **Ao Vivo**.

Próximo passo: [identificar quem está logado](/pixel/identificar).
