Instalando o script
A instalação é uma tag de script no head da página. Ela carrega de forma assíncrona, nunca bloqueia a renderização e não define cookies nos dispositivos dos seus visitantes.
Tag de script
Copie a tag em Integrações. Ela contém a sua chave pública, que é pública por design e só funciona no seu próprio domínio.
<script async src="https://…/l.js" data-loop="pk_live_…"></script>Onde colocar nas plataformas mais comuns
| Plataforma | Onde |
|---|---|
| WordPress | Aparência → Editor de arquivos do tema → header.php, ou um plugin de “scripts no cabeçalho” |
| Ghost | Settings → Code injection → Site header |
| Tistory | Editor de skin → HTML → dentro de <head> |
| Webflow | Site settings → Custom code → Head code |
| Squarespace | Settings → Advanced → Code Injection → Header |
| Wix | Settings → Custom code → Head |
| Shopify | Online Store → Themes → Edit code → theme.liquid |
Instalar com IA
Integrações → Instalar com IA fornece uma instrução para Claude Code, Cursor ou Codex. Ela indica a tag exata a adicionar, onde ela fica no seu framework, o que não tocar e como verificar o resultado. É montada a partir de um texto fixo e revisado e contém apenas a sua chave pública.
React e Next.js
Componentes que envolvem o script e um espaço estão no pacote do SDK. O pacote ainda não foi publicado no npm, então a maioria dos sites deve usar a tag de script; no App Router do Next.js, coloque-a em app/layout.tsx ou use next/script com os mesmos atributos.
Content-Security-Policy
Se o seu site envia um cabeçalho Content-Security-Policy, permita a origem do script em script-src e em connect-src.
Como funciona a verificação
Não há arquivo para enviar nem registro DNS. O script nos chamando a partir de uma página do seu domínio é a prova de que você controla o site. A primeira conta a fazer isso passa a deter o domínio; até lá, qualquer pessoa pode manter um rascunho não verificado dele, e sites não verificados não participam da troca.
Perguntas
- Qual é o tamanho do script?
- Menos de 4 KB compactado.
- Ele define cookies?
- Sem cookies, e nada é armazenado nos dispositivos dos seus próprios visitantes. Uma exceção: no site a que o visitante chega depois de clicar em uma unidade, um token dessa visita é mantido nessa aba do navegador, por até uma hora, para que um cadastro ou uma compra ali possa ser contado. Ele desaparece quando a aba é fechada e nenhum outro site pode lê-lo.
- Posso carregá-lo por um gerenciador de tags?
- Sim, desde que a tag mantenha o atributo data-loop. Carregá-lo diretamente no head verifica o site mais cedo.