Empezar

Seguimiento

El script cuenta algunas cosas por sí solo, y esta página muestra cómo enviar tus propios eventos y cambiar los ajustes de la etiqueta de script.

Lo que cuenta por sí solo

Solo con la etiqueta de script, Runlight registra esto por su cuenta.

Páginas vistas, incluidos los cambios de página en aplicaciones de una sola página (sigue history.pushState, replaceState y el botón de atrás).
Tiempo de atención y profundidad de desplazamiento de cada página vista. El tiempo solo cuenta mientras la pestaña está visible y activa.
Enlaces salientes, registrados como un evento Outbound link con la url cuando alguien hace clic en un enlace a otro sitio.
Descargas de archivos, registradas como un evento File download cuando alguien hace clic en un enlace a un PDF, un zip, una imagen de disco, un documento o un archivo de audio o vídeo.
Errores 404, en una página cuya etiqueta de script tiene data-404 (ver abajo). Cada uno es un evento llamado 404 cuya propiedad path es la dirección que no se encontró, así que las propiedades de 404 en el recuadro Eventos enumeran las direcciones rotas a las que llegó la gente y con qué frecuencia.

Runlight ignora las visitas de bots conocidos y de navegadores controlados por automatización, como Playwright, Selenium y Puppeteer.

Tus propios eventos

Llama a runlight con un nombre y, si quieres, algunas propiedades.

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

Las propiedades pueden ser cadenas, números o booleanos. Cada evento admite hasta 30, con nombres de hasta 60 caracteres y valores de hasta 500. Los eventos cuentan para las visitas y pueden ser objetivos.

Si tu código puede ejecutarse antes de que se cargue el script, pon las llamadas en cola.

html

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

Clics sin JavaScript

Dale a cualquier elemento un atributo data-runlight y un clic en él enviará ese evento. Los atributos data-runlight-* adicionales se convierten en propiedades.

html

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

Para contar clics en algo que no puedes editar, añade un objetivo de clic en el panel, que no necesita nada de código.

Ajustes de la etiqueta de script

Atributo	Qué hace
`data-site="id"`	Qué sitio, cuando una instalación cuenta varios y los nombres de host no bastan.
`data-hash`	Cuenta los cambios de `location.hash` como páginas vistas (para routers con hash).
`data-404`	Marca esta página como un 404, para que la página vista registre también un evento `404` con la ruta de la página. Ponlo en tu página de no encontrado, como hacen por ti los plugins de WordPress, Drupal y Craft.
`data-dnt`	Respeta Do Not Track. Está desactivado por defecto, ya que Runlight no guarda nada personal.
`data-outbound="false"`	No registra los clics en enlaces salientes.
`data-downloads="false"`	No registra las descargas de archivos.
`data-exclude="/admin/*,/preview"`	No registra nada en estas páginas, ni páginas vistas ni eventos. Separa los patrones con comas y usa `*` para cualquier cosa.
`data-manual`	No envía páginas vistas por sí solo. Llama a `runlight.pageview()` cuando se muestre una página, o a `runlight.pageview("/checkout/step-2")` para darle nombre a la página.

Dejarte fuera

En el panel, Ajustes, General tiene un interruptor Ignorar este navegador. Si tu panel está en otro dominio que el sitio, abre cualquier página del sitio con ?runlight=ignore una vez en cada navegador que uses; ?runlight=track lo deshace. Esta marca es lo único que el script guarda, y solo existe en los navegadores donde decidiste ponerla.