Início

Rastreamento

O script conta algumas coisas sozinho, e esta página mostra como enviar seus próprios eventos e mudar as configurações na tag do script.

O que ele conta sozinho

Só com a tag do script, o Runlight registra isto por conta própria.

Visualizações, incluindo as trocas de página em single page apps (ele acompanha history.pushState, replaceState e o botão voltar).
Tempo de engajamento e profundidade de rolagem de cada visualização. O tempo só conta enquanto a aba está visível e em foco.
Links externos, registrados como um evento Outbound link com a url quando alguém clica num link para outro site.
Downloads de arquivos, registrados como um evento File download quando alguém clica num link para um PDF, zip, imagem de disco, documento, áudio ou vídeo.
404s, numa página cuja tag do script tem data-404 (veja abaixo). Cada um é um evento chamado 404 cuja propriedade path é o endereço que não foi encontrado, então as propriedades de 404 no quadro Eventos listam os endereços quebrados que as pessoas acessaram e com que frequência.

O Runlight ignora visitas de bots conhecidos e de navegadores controlados por automação, como Playwright, Selenium e Puppeteer.

Seus próprios eventos

Chame runlight com um nome e, se quiser, algumas propriedades.

runlight("Newsletter signup", { source: "footer" });
runlight("Purchase", { plan: "pro", revenue: 49 });

As propriedades podem ser strings, números ou booleanos. Cada evento aceita até 30 delas, com nomes de até 60 caracteres e valores de até 500. Os eventos contam para as visitas e podem ser metas.

Se o seu código puder rodar antes de o script carregar, coloque as chamadas numa fila.

html

<script>
  window.runlight = window.runlight || function () { (window.runlight.q = window.runlight.q || []).push(arguments); };
</script>

Cliques sem JavaScript

Dê a qualquer elemento um atributo data-runlight, e um clique nele envia esse evento. Atributos data-runlight-* extras viram propriedades.

html

<button data-runlight="Signup" data-runlight-plan="pro">Sign up</button>

Para contar cliques em algo que você não pode editar, adicione uma meta de clique no painel, que não precisa de código nenhum.

Configurações na tag do script

Atributo	O que faz
`data-site="id"`	Qual site, quando uma instalação conta vários e os nomes de host não bastam.
`data-hash`	Conta mudanças em `location.hash` como visualizações (para roteadores com hash).
`data-404`	Marca esta página como 404, para que a visualização também registre um evento `404` com o caminho da página. Coloque-o na sua página de não encontrado, como os plugins de WordPress, Drupal e Craft fazem por você.
`data-dnt`	Respeita o Do Not Track. Fica desligado por padrão, já que o Runlight não guarda nada pessoal.
`data-outbound="false"`	Não registra cliques em links externos.
`data-downloads="false"`	Não registra downloads de arquivos.
`data-exclude="/admin/*,/preview"`	Não registra nada nestas páginas, nem visualizações nem eventos. Separe os padrões com vírgulas e use `*` para qualquer coisa.
`data-manual`	Não envia visualizações sozinho. Chame `runlight.pageview()` quando uma página for exibida, ou `runlight.pageview("/checkout/step-2")` para dar nome à página.

Deixar suas próprias visitas de fora

No painel, Configurações, Geral tem um botão Ignorar este navegador. Se o seu painel está num domínio diferente do site, abra qualquer página do site com ?runlight=ignore uma vez em cada navegador que você usa; ?runlight=track desfaz isso. Essa marcação é a única coisa que o script guarda, e ela só existe nos navegadores onde você escolheu defini-la.