Instale o script de rastreamento

O Clakta registra as visitas ao seu site por meio de um script: um pequeno código que você cria no seu projeto e adiciona às suas páginas. Um projeto pode ter vários, por exemplo um por site.

1. Crie o script

Vá em Configurações do projeto → Script e clique em Criar script.

Nome

Qualquer nome que ajude a diferenciar os seus scripts depois, como Site principal.

Domínios

Os sites que podem enviar dados com este script. Adicione cada um sem o https://:

example.com
shop.example.com

Dados de qualquer outro site são recusados, então uma cópia do seu site não consegue misturar dados falsos aos seus.

Eventos rastreados automaticamente

Escolha o que o script registra sozinho:

Mantenha Page views ligado: a atribuição depende dele. Os outros você pode ligar ou desligar quando quiser.

2. Adicione ao seu site

Salve o script e clique em Instruções de instalação na linha dele. O código ali já vem com o id do seu script preenchido.

Cole o código

Copie o código e cole dentro do <head> de todas as páginas do seu site:

<script
  src="https://cdn.clakta.com/script.js"
  data-id="YOUR_SCRIPT_ID"
  data-auto-init
  defer
></script>

O data-auto-init começa a registrar assim que a página carrega. Tire ele só se quiser começar a registrar você mesmo, por exemplo depois que o visitante aceita um banner de consentimento, chamando clakta.init({ id: "YOUR_SCRIPT_ID" }).

Next.js

Instale o SDK:

npm install @clakta/nextjs

Depois adicione o provider uma vez, no layout raiz:

import { ClaktaProvider } from "@clakta/nextjs"

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <ClaktaProvider id="YOUR_SCRIPT_ID" />
        {children}
      </body>
    </html>
  )
}

Passe o id direto. O provider inicia uma única vez por página, então um valor que chega depois é ignorado.

React ou JavaScript puro

Instale o pacote:

npm install @clakta/javascript

import clakta from "@clakta/javascript"

clakta.init({ id: "YOUR_SCRIPT_ID" })

Durante a configuração, adicione debug: true para ver no console do navegador o que o script está fazendo. Para banners de consentimento, veja Gestão de consentimento.

3. Confira se carregou

Nas instruções de instalação, clique em Testar seu site e digite um dos seus domínios. O Clakta abre a página e procura o script. Um resultado verde quer dizer que o script está naquele site.

Isso só prova que o script está lá. Para conferir se os dados estão chegando, vá para Valide sua configuração.

Erros comuns

Próximo passo

Valide sua configuração.