Disponibilidad del plan
Disponible para Grabaciones y Mapas de calor con Observe , Observe
, o Observe
Disponible para Grabaciones y Mapas de calor con Observe
, Observe
Disponible para Feedback y Encuestas con Ask , Ask
, o Ask
La API de Eventos de Hotjar te permite enviar eventos a Hotjar utilizando JavaScript cuando se producen acciones específicas en tu sitio, guardándolos dentro de Hotjar como Eventos. Estos eventos se pueden utilizar para ayudarte a filtrar los datos recopilados de Grabaciones y Mapas de calor, y para activar la captura de sesiones para iniciar o hacer que aparezcan widgets de Feedback y Encuestas.
- Resumen
- La llamada a la API de Eventos
- Ejemplos de llamadas a la API de Eventos
- Mejores prácticas
- Pruebas de Eventos
Puedes enviar Eventos utilizando Google Tag Manager, Google Analytics o Segment
Es posible comenzar a enviar Eventos a Hotjar utilizando Google Tag Manager, Google Analytics o Segment. Para más detalles, consulta nuestro artículo Cómo enviar Eventos con Google Tag Manager, Usar Hotjar con Google Analytics, o si estás utilizando Segment visita nuestra guía Usar Hotjar con Segment.
Resumen
Los Eventos de Hotjar representan las acciones que un usuario realizó mientras estaba en tu sitio. Estos eventos se definen y se envían a Hotjar a través de tu código del lado del cliente mediante la API de Eventos de Hotjar. Esta API está disponible en todas las páginas que contienen el Código de Seguimiento de Hotjar.
Con JavaScript, puedes establecer tus propios criterios para determinar qué tipo de acción resulta en el envío de un evento a Hotjar. El evento podría enviarse tan pronto como se carga la página, cuando aparece un modal, o cuando ven una variación específica del contenido a través de una prueba A/B.
Por ejemplo, puede ser útil hacer un seguimiento de los usuarios que han añadido con éxito una tarjeta de crédito durante un proceso de pago añadiendo un evento como Se añadió la tarjeta de crédito con éxito. También puede interesarte comparar sesiones donde una tarjeta de crédito no se añadió con éxito añadiendo un segundo evento, como Error al añadir la tarjeta de crédito. Al pasar eventos basados en acciones de usuario, puedes filtrar las Grabaciones por usuarios que activaron cada tipo de evento durante su proceso de pago. Configurar estos eventos en el código de tu sitio podría parecerse a esto:
fetch('/api/add-credit-card', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
})
.then((response) => response.json())
.then((data) => {
hj('event', 'Se añadió la tarjeta de crédito con éxito')
// manejar la respuesta del backend.
}
)
.catch(error => {
hj('event', 'Error al añadir la tarjeta de crédito')
})
*Consulta a tus propios desarrolladores para determinar qué código será necesario para tu sitio.
Dado que los criterios para enviar eventos se basan en tu propio código, la función es muy flexible pero requerirá programación personalizada de tu desarrollador web.
¿Hotjar todavía admite Disparadores y Etiquetas añadidos mediante JavaScript?
En el pasado, Hotjar utilizaba hj('trigger', 'ejemplo'); para disparar eventos con fines de segmentación, y hj('tagRecording', ['ejemplo_etiqueta_1', 'ejemplo_etiqueta_2']); para adjuntar etiquetas para filtrar grabaciones. Estos eventos heredados se denominaban Disparadores y Etiquetas de JavaScript respectivamente.
Si tu sitio ya está utilizando las llamadas 'trigger' o 'tagRecording', Hotjar seguirá respetándolas y no dejarán de funcionar. Sin embargo, un 'trigger' no será buscable en los filtros de Grabaciones, y una 'etiqueta' no se puede utilizar para dirigir las herramientas de Hotjar.
La llamada a la API de Eventos
A continuación se muestra el formato básico para una llamada a la API de Eventos:
hj('event', 'nombre_de_la_accion');
- El primer parámetro siempre debe contener el valor de cadena event.
- El segundo parámetro es el nombre personalizado asignado a tu evento. En el ejemplo anterior, el nombre del evento es nombre_de_la_accion, pero esto puede ser cualquier cosa que elijas. (Ejemplo: 'abrió_modal', 'mostró_variante_a', etc.)
Ten en cuenta las limitaciones al implementar eventos
-
Nombrar tus Eventos.
El nombre del evento no debe exceder los 250 caracteres y solo puede contener cualquiera de lo siguiente: caracteres alfanuméricos (a-z, A-Z, 0-9), espacios, guiones bajos (_), guiones (-), puntos (.), dos puntos (:) y barras inclinadas (/).
-
Hay un límite de 10,000 eventos únicos por sitio de Hotjar.
Los Filtros de Hotjar solo admitirán 10,000 eventos únicos por sitio de Hotjar, con un número ilimitado de usuarios asociados a esos eventos. Si excedes esto, solo 10,000 de los eventos más utilizados (ordenados 0-9, a-Z) serán buscables en la interfaz. Este es un total acumulativo, por lo que una vez que se excede el límite, algunos eventos existentes pueden volverse no buscables en el filtro. Si excedes el límite, puedes eliminar grabaciones que contengan eventos que ya no necesitas. Alrededor de 10 minutos después de la eliminación, tu lista de filtros de eventos se actualizará.
-
Solo los primeros 50 eventos únicos en una sola sesión serán buscables por filtros.
Para optimizar el rendimiento, Hotjar solo evaluará los primeros 50 eventos únicos en una sesión al determinar si una sesión coincide con los criterios de filtro de eventos. Esto significa que si una sesión contiene 51 eventos únicos, el último evento único que se activó durante la sesión no se detectará si filtraste grabaciones basadas en ese evento. Sin embargo, los 51 eventos seguirán siendo visibles en la vista de reproducción de grabaciones de cada sesión. -
Actualmente no es posible pasar ninguna propiedad de evento con el evento.
Ejemplos de llamadas a la API de Eventos
A continuación se muestran algunos casos de uso de ejemplo para eventos.
-
Enviar un evento a Hotjar que puedas usar para activar una Encuesta cuando un usuario hace clic en un botón de Suscripción.
hj('event', 'suscripción_a_lista_de_correo');
-
Enviar un evento a Hotjar relacionado con un error específico, para que puedas filtrar tus grabaciones por usuarios que encontraron un error durante su sesión.
hj('event', 'error_ocurrido');
-
Enviar un evento a Hotjar para saber cuándo un usuario carga una variante específica de página durante una prueba A/B.
hj('event', 'variante_b_mostrada');
Mejores prácticas
-
No pase Información de Identificación Personal como un Evento.
La información de identificación personal (PII) nunca debe usarse como eventos en Hotjar. Si desea conectar datos de sesión con usuarios específicos, debería explorar la función de Atributos de Usuario en su lugar.
-
Si también estás realizando llamadas a la API de Identificación, estas deben ejecutarse antes de las llamadas a la API de Eventos.
Puede que desees combinar Eventos con la segmentación basada en Atributos de Usuario para activar Encuestas o Retroalimentación. Para configurar esto, el orden de ejecución requiere que la llamada a la API de Identificación ocurra antes de la llamada a la API de Eventos, teniendo en cuenta cualquier llamada asíncrona a otros servicios. Si la llamada a la API de Eventos se ejecuta antes de que la llamada a la API de Identificación haya terminado, el widget de Encuesta o Retroalimentación no se mostrará.
-
Los Eventos no pueden usarse para recopilar direcciones de correo electrónico o IP, ni números con 9 o más dígitos.
Dado que actualmente no hay forma de utilizar nuestra herramienta de Búsqueda de Usuario con eventos, no se pueden usar para recopilar correos electrónicos, direcciones IP o números con 9 o más dígitos para evitar que se envíen números de tarjetas de crédito a Hotjar. Esta decisión se basa en el Reglamento General de Protección de Datos (GDPR). Si deseas recopilar direcciones de correo electrónico con el consentimiento de tus usuarios y de acuerdo con el GDPR, puedes hacerlo con Atributos de Usuario.
-
El Código de Seguimiento de Hotjar debe cargarse antes de enviar cualquier Evento.
El objeto hj() no puede ser accedido hasta que el Código de Seguimiento de Hotjar se haya ejecutado en la página. Si el script que llama a la API de Eventos se agrega antes de tu Código de Seguimiento de Hotjar, habrá un error y el evento no será reconocido. Si por alguna razón se está accediendo a la API de Eventos antes de que se haya ejecutado el Código de Seguimiento de Hotjar, entonces puedes agregar la siguiente línea de código antes de llamar al código de la API de Eventos:
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments);};
-
Para sitios de comercio electrónico, evita enviar información específica de productos.
Esto incluye información como códigos SKU. Por lo general, las URL son más útiles y se capturan de forma predeterminada.
-
Ten cuidado al enviar valores de objetos como capas de datos de GTM.
A menudo contienen más datos de los que esperas.
- Avoid pasar cosas como fechas o marcas de tiempo.
- Avoid pasar cosas de las URL como códigos de referencia.
- Avoid pasar registros de errores detallados.
Pruebas de Eventos
Seguir los pasos a continuación te permitirá confirmar si tus llamadas a la API de Eventos son recibidas con éxito por Hotjar. Si no estás familiarizado con la consola de tu navegador o las herramientas de desarrollo, considera involucrar a un miembro del equipo que tenga más conocimientos sobre estas herramientas o a un desarrollador web para que te ayude.
Habilita los registros de depuración de Hotjar en la consola de tu navegador.
Abre la página donde deseas probar el Evento y agrega el parámetro ?hjDebug=1 al final de la URL. Aquí tienes un par de ejemplos de cómo podría verse:
https://www.ejemplo.com/?hjDebug=1
O
https://www.ejemplo.com/?utm_1234&hjDebug=1
Abre la consola de tu navegador.
Si no estás familiarizado con las herramientas de desarrollo de tu navegador, o la consola, consulta esta guía para aprender cómo abrir la consola de tu navegador.
Dispara el evento manualmente.
Para disparar tu evento manualmente, agrega el código de la API de Eventos en la consola de tu navegador y presiona Enter o Return en tu teclado. Si el evento se disparó con éxito, verás un registro de confirmación similar a este:
También recomendamos que sigas los pasos que seguiría tu usuario para activar el evento automáticamente. Si el evento se activa automáticamente, sabrás que tu código se implementó con éxito.
Si se detecta el mismo evento al dispararse manualmente, pero no automáticamente al probar el recorrido del usuario, entonces es posible que necesites revisar tu código y los criterios que determinan cuándo se envía la llamada de la API de Eventos.