Rastrear eventos

Una vez que el tracker está instalado, se recopila mucho sin escribir ningún código: páginas vistas, profundidad de scroll, errores de JavaScript y, si dejas la captura automática activada, cada clic relevante. Esta página explica qué es automático, qué puedes añadir tú y cómo leer las señales de frustración.

Páginas vistas

Una página vista se registra con la URL completa, la ruta, el referrer y el título de la página. Cómo se activa depende de cómo hayas instalado el tracker:

Aplicaciones de página única

Con la etiqueta script, el tracker envuelve las funciones de historial del navegador y escucha los botones de atrás y adelante. Solo se envía una nueva página vista cuando cambia la ruta. Un cambio de query string o de #hash por sí solo no cuenta como una página nueva.

Cuando un visitante pasa a otra página, el tracker también envía los datos de scroll de la página que abandona y, si la grabación está activada, inicia una captura nueva para la nueva ruta. Gracias a eso, los mapas de calor y las grabaciones muestran cada página por separado.

Eventos personalizados

Usa un evento personalizado para contar algo que el tracker no puede adivinar: un registro, un cambio en una tabla de precios, la descarga de un archivo.

// Script tag
window.klickbee.track("signup_clicked", { plan: "pro" });

// npm package
tracking.track("signup_clicked", { plan: "pro" });

Reglas que conviene conocer:

• El nombre es una cadena de hasta 255 caracteres.
• Las propiedades son opcionales y deben ser planas: cada valor es una cadena, un número, un booleano o null. No se aceptan objetos anidados ni arrays.
• Los nombres que empiezan por $ están reservados para los eventos propios del tracker ($scroll, $deadclick, $ragescroll, $error, $experiment). No los uses para los tuyos.
• Usa nombres estables y en minúsculas, como signup_completed. Los objetivos y los embudos coinciden con los nombres de forma exacta, incluidas las mayúsculas y minúsculas.

Encontrarás tus eventos en el panel en varios sitios:

• Overview: la lista Top events.
• Live events: un feed en tiempo real de lo que se está capturando.
• Sessions: la cronología de eventos de una sesión.
• Funnels: como pasos de tipo Event.
• Goals: como objetivos de tipo Event.

Los eventos también pueden llevar un valor y una moneda para las plataformas publicitarias: rastrea purchase con { value: 49.9, currency: "EUR" } y apunta una asignación de conversión a esas dos propiedades. Consulta Conversiones.

Autocapture: clics sin código

Con autocapture activado, el tracker registra los clics en botones, enlaces y otros elementos interactivos, sin ningún código por tu parte. Por cada clic guarda el selector CSS del elemento, su texto visible o su etiqueta, el destino del enlace y en qué parte de la página se hizo clic.

• Etiqueta script: autocapture está activado salvo que definas data-autocapture="false".
• Paquete npm: autocapture está desactivado salvo que definas autocapture: true.

Autocapture alimenta el mapa de calor de clics, los objetivos de clic (consulta Objetivos), el feed de Live events (tipo «autocapture») y tres de las señales de frustración que se describen más abajo. Los mapas de calor también necesitan que la grabación esté activada, porque la imagen de la página procede de una grabación.

Se captura el texto visible o accesible del elemento, hasta 255 caracteres. Los marcadores data-kb-mask y data-kb-block descritos en Privacidad y consentimiento solo se aplican a la grabación de sesiones, no a la captura automática de clics. Si el texto de un elemento clicable puede contener algo personal (un nombre, una dirección de correo electrónico), dale un aria-label sin datos personales, que se captura en lugar del texto, o desactiva autocapture.

Identificar a tus visitantes

Llama a identify cuando sepas quién es alguien, normalmente después del inicio de sesión:

window.klickbee.identify("user_1234", { plan: "pro" });

A partir de ese momento, sus sesiones llevan ese identificador: se muestra en la página de la sesión y en el live feed, para que puedas encontrar las sesiones de un cliente concreto. Llama a reset() cuando cierren sesión para que la siguiente persona que use el mismo navegador no se mezcle con ellos.

Señales de frustración

Klickbee detecta los momentos en los que un visitante se atasca y los muestra en la lista de Sessions, en la página de la sesión y en la línea de tiempo de la grabación.

Cada sesión recibe una insignia Frustration. Pasa el cursor por encima para ver el desglose, por ejemplo «3 rage · 1 dead · 1 U-turn». En la página Sessions, el filtro Frustration only conserva solo las sesiones que contienen al menos una señal. Consulta Sesiones y mapas de calor.

Errores de JavaScript

A menos que lo desactives con captureErrors: false (paquete npm), el tracker registra los errores no capturados y los rechazos de promesas no gestionados como eventos $error. Para proteger tu cuota y tus datos, un mensaje se recorta a 255 caracteres, los errores idénticos repetidos se omiten y se envían como máximo 10 por página.

Variantes de test A/B (paquete npm)

Si ejecutas un test en el front-end, tracking.experiment("pricing_test", "b") registra qué variante vio un visitante. La página Experiments, en Variant test, compara después las variantes frente a un objetivo. Este método no está disponible en window.klickbee, así que necesita el paquete npm.

Relacionado

• Objetivos: convierte páginas vistas, eventos y clics en conversiones.
• Embudos, rutas y retención
• Solución de problemas