Disponible para Recordings y Heatmaps con los planes Observe 
o 
. Disponible para Feedback y Encuestas con los planes Ask o . Consulta la página de precios de Hotjar para conocer los planes y precios.
La API de identificación de Hotjar (Identify API) te permite pasar datos sobre tus usuarios a Hotjar usando Javascript, guardándolos como Atributos de Usuario. Puedes utilizar estos atributos en Hotjar para permitir el filtrado avanzado y la segmentación. Puede enviar hasta 100 atributos de usuario relacionados con cualquier sitio, con cualquier número de usuarios asociados a esos atributos.
Puedes utilizar los atributos de usuario utilizar para filtrar Recordings, segmentar encuestas y widgets de Feedback, o realizar búsquedas de usuarios y solicitudes de eliminación por ID de usuario.
Sigue los siguientes enlaces para obtener más información sobre los atributos de usuario:
- Información general
- Gestión de ID de usuario
- Llamadas a la API de identificación
- Valores de atributos de usuario
- Manejo de direcciones de correo electrónico
- Ejemplos de transmisión de atributos de usuario a Hotjar
- Uso de API de identificación de forma legalmente compatible
- Desactivación de atributos de usuario
- Eliminación de atributos de usuario
- Mejores prácticas
- Preguntas frecuentes
Puedes enviar Atributos de Usuario usando Google Tag Manager o Segment
Es posible empezar a enviar Atributos de Usuario a Hotjar usando Google Tag Manager o Segment. Para más detalles, consulta nuestro artículo Cómo enviar atributos de usuario con Google Tag Manager y Usando Hotjar con Segment.
Información general
Los Atributos de Usuario son valores de datos sobre los usuarios de tu sitio pasados a Hotjar desde tu código del lado del cliente a través de la API de identificación de Hotjar. Esta API está disponible en todas las páginas que contienen el código de Hotjar.
Estos datos se pasan a Hotjar en pares clave-valor como una llamada AJAX asíncrona a los servidores de Hotjar. Estos valores se asocian con un ID de usuario, un valor identificable de forma única que se pasa a Hotjar en su código a partir de un valor de ID de usuario de su base de datos de usuarios. Esto permite a Hotjar asociar los datos recogidos sobre ellos con el mismo ID de usuario que utilizas en tu propia base de datos, así como consultar la información de usuario guardada en Hotjar sobre ese usuario.
Hay 4 fases en el proceso de enviar atributos de usuario y utilizarlos con Hotjar.
- Obtener los datos de tu sitio.
- Pasar los datos a Hotjar a través de la API de identificación.
- Hotjar almacena los datos sobre cada usuario como Atributos de Usuario contra su user_id.
- Ahora puedes utilizar las herramientas de Hotjar para segmentar y filtrar por Atributos de Usuario.
Llamadas a la API de identificación
Antes de que puedas empezar a llamar a Identify, los Atributos de Usuario deben estar habilitados en la configuración de Hotjar para cada sitio con el que quieras usar Atributos de Usuario.
Activación y desactivación de los atributos de usuario
La capacidad de acceder a la API de identificación y a los Atributos de Usuario estará habilitada por defecto si esta función está incluida en su plan Hotjar. Sin embargo, si los Atributos de Usuario fueron deshabilitados en el pasado, puede que necesites volver a habilitarlos para su uso.
En tu página de Atributos de Usuario (Configuración Atributos de Usuario), encuentra el Sitio al que quieres añadir Atributos de Usuario usando el menú desplegable de selección. Verás algo como esto mostrando el estado de la implementación de tus Atributos de Usuario:
También puedes desactivar los Atributos de Usuario en esta página. Una vez que hayas seleccionado un Sitio con Atributos de Usuario habilitados, haz clic en Deshabilitar Atributos de Usuario. Una vez hecho esto, se bloquearán más llamadas a la API. El botón "Desactivar Atributos de Usuario" sólo aparecerá después de que los datos de atributos de usuario hayan sido recibidos por Hotjar, pero no antes.
Cualquier informe que dependa de los Atributos de Usuario para su segmentación será desactivado, y no podrás volver a activarlos a menos que cambies sus opciones de segmentación, o vuelvas a activar los Atributos de Usuario.
Si quieres evitar que se envíen atributos de usuario en el futuro, debes eliminar el código de la API de identificación de tu sitio. Una vez eliminado el código de tu sitio, los Atributos de Usuario recopilados previamente seguirán existiendo, pero ya no se actualizarán ni se añadirán a los nuevos usuarios de tu sitio.
La llamada a la API
Este es el formato de una llamada a la API de identificación:
hj('identify', userId, {
user_attribute: value
});
- El primer parámetro debe contener siempre el valor de cadena "identify".
- El segundo debe ser una cadena que contenga el id de usuario para un usuario en tu sitio, de tu propia base de datos de usuarios, o null si no se conoce.
- El tercero es una serie de pares clave-valor dentro de un objeto. La clave proporciona el nombre del atributo de usuario, y el valor define tanto el tipo de atributo de usuario como su valor para ese usuario.
Los valores introducidos en esta llamada deben proceder del código base de tu sitio web. Estos valores pueden ser extraídos directamente de sus servidores o generados por el cliente.
Una vez enviados a Hotjar, estos atributos y los valores de cada usuario se almacenan en los servidores de Hotjar. Cada vez que se realice una llamada a Identify, los valores almacenados en los servidores de Hotjar se sustituirán por los valores más recientes de estos atributos.
Puede consultar todos los atributos enviados a Hotjar en la página de configuración de Atributos de usuario. Puede utilizar la función de Búsqueda de Usuario para inspeccionar qué valores se han pasado para un usuario específico en tu sitio.
Siempre que se identifique a un usuario durante su sesión, Hotjar puede asociar IDs de usuario y atributos de usuario con el registro de una sesión, y ofrecer una segmentación detallada del widget de Feedback, permitiéndole obtener feedback de usuarios específicos utilizando Feedback y Encuestas. Por ejemplo: "Quiero que esta encuesta sólo se dirija a los clientes de pago que hayan realizado una compra hace más de 10 días".
Las Recordings se guardarán con los valores más recientes enviados a Hotjar durante la sesión.
Si envía varias llamadas a Identify durante la sesión de un usuario, Hotjar siempre se actualizará con los valores más recientes. Esto significa que es importante que los ID de usuario y los atributos de usuario se envíen de forma coherente con cada llamada, lo que permitirá a Hotjar conectar una grabación a un usuario específico.
Manejo de IDs de Usuario
El segundo argumento que se pasa a Hotjar a través de la llamada a la API Identify debe ser un ID de usuario identificable de forma única desde la base de datos de tu propio sitio. Los Atributos de Usuario están asociados con este ID de Usuario.
El ID de usuario debe ser único por usuario, pero no debe contener información personal. También debe ser un valor que nunca cambie para este usuario. Una vez que haya establecido un ID de usuario en Hotjar, no se puede cambiar. Si cambia, Hotjar considerará que se trata de un usuario totalmente nuevo.
Si un ID de usuario está identificado, el Hotjar ID del usuario se asociará con su ID de usuario. Un ID de Hotjar es un ID de usuario único generado aleatoriamente, creado a nivel del Sitio Hotjar. Si un usuario no tiene un ID de usuario cuando visita un sitio inicialmente, entonces el ID de Hotjar se asociará con su ID de usuario una vez que se realice la llamada a la API de identificación con un ID de usuario.
Más abajo puedes ver un ejemplo.
Digamos que tenemos un usuario, Rachel. Ella visita el sitio 3 veces en 2 dispositivos diferentes.
- Sesión A - Raquel visita radbooks.com en su tableta.
- Aún no es usuaria del sitio y se le asigna un ID Hotjar de 123.
- Sesión B - Rachel visita el sitio desde su móvil.
- Aún no es usuaria y se le asigna un ID Hotjar de 456.
- Sesión C - Rachel vuelve al sitio desde su móvil.
- Hotjar la reconoce con el ID Hotjar de 456.
- Después, crea una cuenta.
- Su llamada a API Identify le asigna un ID de usuario de ABC, utilizando el mismo ID de usuario que tiene para ella en su base de datos.
Como la hemos asociado con un ID de usuario en tu sitio, conectamos todos los datos asociados con el ID 456 de Hotjar con su ID de usuario ABC, aunque no haya iniciado sesión durante la sesión B.
Si Rachel vuelve a visitar el sitio en su tableta en una cuarta sesión, y esta vez inicia sesión, Hotjar unirá los datos de la Sesión A con los de la Sesión B y C, ofreciéndole una imagen completa de sus interacciones con tu sitio.
¿Qué sucede si no tienes un ID de usuario?
Si no utilizas el ID de usuario, hay que pasar un valor nulo al segundo parámetro. Al hacer esto, todos los atributos de usuario pasados a la API de identificación se asociarán con el ID de Hotjar del usuario.
No pases información de identificación personal como un atributo de usuario sin un ID de usuario.
Si un ID de usuario no es conocido (pasando un valor nulo), entonces cualquier otro Atributo de Usuario pasado a Hotjar no debe contener ninguna información de identificación personal (PII). Su capacidad para buscar atributos de usuario asociados con un usuario individual en Hotjar depende de que pueda buscar su ID de usuario. Hotjar no tiene forma de recuperar o eliminar estos datos a menos que elimine todo el Sitio en Hotjar.
Valores de los Atributos de Usuario
Puedes pasar los siguientes valores a una clave de Atributo de Usuario utilizando la API Identify. No es posible utilizar los caracteres especiales en este momento.
Gestión de direcciones de correo electrónico
Actualmente, existe una clave de atributo de usuario para las direcciones de correo electrónico: email. Las direcciones de correo electrónico deben pasarse como cadenas a email. Por ejemplo
hj('identify', userId, {
email: 'test@test.com'
});
Si cualquier otro atributo de usuario de tipo cadena contiene una dirección de correo electrónico, será rechazado, por lo que sólo debe utilizar `email` para pasar direcciones de correo electrónico.
Direcciones de correo electrónico e ID de usuario
user_id puede tomar la forma de direcciones de correo electrónico, por lo que si la clave principal de su base de datos para los usuarios es su dirección de correo electrónico, esta puede ser utilizada como user_id. Esto debe utilizarse sólo como último recurso. Si la clave principal de un usuario en su base de datos no es una dirección de correo electrónico, debería utilizarla.
Debido a que las direcciones de correo electrónico normalmente pueden cambiar, si su dirección de correo electrónico se actualiza, Hotjar tratará a ese usuario como un usuario totalmente diferente. Esto te impediría utilizar User Lookup en la dirección de correo electrónico anterior, lo que podrías incumplir sus requisitos de privacidad.
Ejemplos de transmisión de atributos de usuario a Hotjar
Identificación de clientes de pago
Aquí hay un ejemplo, donde queremos ser capaces de decirle a Hotjar cuánto dinero alguien ha gastado en tu sitio.
hj('identify', userId, {
total_spend: 500
});
Se pueden pasar múltiples atributos añadiendo más pares clave-valor al objeto. ¿Quizás quieres que Hotjar sepa cuándo se convirtieron en clientes por primera vez?
hj('identify', userId, {
total_spend: 500,
first_purchase: '2019-06-20Z'
});
Aquí le estamos diciendo a Hotjar que tu usuario se convirtió en cliente de tu servicio usando una cadena de fecha ISO8601.
Identificando Atributos para Usuarios Anónimos
A veces es útil rastrear información sobre los usuarios en tu sitio, incluso si todavía no son usuarios o clientes de pago. Supongamos que desea realizar un seguimiento de la fuente de referencia y la variante de prueba A-B de la página de destino desde la que llegó un posible cliente potencial:
hj('identify', null, {
ab_test: 'variant-A',
referrer: 'facebook_paid'
});Esto sería útil si quisieras dirigir una encuesta a los usuarios de la variante A, o sólo a aquellos que llegaron a ti desde anuncios de pago de Facebook, por ejemplo.
Uso de la API de identificación y obligaciones legales
La API de identificación está desactivada de forma predeterminada, lo que facilita evitar la captura accidental de información personal hasta que hayas gestionado adecuadamente los problemas de privacidad. Al habilitar los Atributos de Usuario, es posible que esté pasando los datos personales de sus usuarios finales a Hotjar. Requerimos que reconozcas tus obligaciones legales al hacerlo y aceptes el Acuerdo de Procesamiento de Datos de Hotjar.
Es su responsabilidad utilizar esta función de una manera legalmente compatible, en acuerdo con las leyes de tu país y de los países que visitan tus usuarios. Visita nuestra página de privacidad para obtener más información sobre el enfoque de Hotjar con respecto a la privacidad del usuario. Cuando utilices los Atributos de Usuario, tienes que conocer y cumplir las Condiciones de Servicio y la Política de Uso Aceptable de Hotjar.
Gestión de solicitudes de búsqueda y eliminación de usuarios
Es posible buscar y borrar los datos de un usuario utilizando su ID de usuario. Más información en nuestro artículo "Cómo utilizar User Lookup". Es importante tener en cuenta que si conoces el ID de usuario y la dirección de correo electrónico de un usuario, tienes que buscar su información utilizando ambos. Esta es la única manera de asegurarse de que toda la información personal que Hotjar tiene sobre este usuario ha sido buscada y eliminada.
Deshabilitando Atributos de Usuario
Para prevenir que más Atributos de Usuario sean enviados a Hotjar, hay que deshabilitar los Atributos de Usuario.
Mientras los Atributos de Usuario estén habilitados en tu sitio, si quieres evitar que se envíen en el futuro, debes eliminar el código de tu sitio que los envía a Hotjar. Una vez que el código es eliminado de tu sitio, los Atributos de Usuario previamente recolectados seguirán existiendo, aunque ya no serán actualizados o añadidos a los nuevos usuarios de tu sitio.
Eliminación de atributos de usuario
Los Atributos de Usuario ahora pueden ser eliminados desde la página de gestión de Atributos de Usuario haciendo clic en el icono de la papelera a la derecha del atributo. Sólo los miembros del equipo con permisos de 'Lectura y Escritura' o superiores pueden eliminar Atributos de Usuario.
Asegúrate de eliminar cualquier atributo de usuario eliminado de todas las llamadas a la API de identificación.
La eliminación de un atributo de usuario no lo eliminará de las sesiones existentes ni de las respuestas que lo contengan. El atributo sólo se eliminará del filtrado y la focalización. No olvide eliminar el atributo de usuario eliminado de todas las llamadas a la API de identificación; de lo contrario, volverá a aparecer en la lista.
Buenas prácticas
Cuándo realizar llamadas a la API de identificación
Es recomendable realizar llamadas a Identify cada vez que:
- Se cargue una página con los valores más recientes (aunque no hayan cambiado).
- Tras un cambio de URL en aplicaciones de una sola página.
- Cada vez que se realice un cambio. Por ejemplo, si quisieras hacer un seguimiento de la última compra en una tienda, querrías actualizar este atributo de usuario una vez que se haya realizado una compra.
Cada llamada actualizará los Atributos de Usuario con Hotjar con los valores más recientes. Cuando finaliza una sesión, la Grabación guarda los valores más recientes en el momento en que finaliza la sesión. Cuando se realiza una llamada, pero los valores no han sido actualizados, la petición de red no será enviada para evitar peticiones AJAX innecesarias.
Combinación de llamadas a la API de identificación con activadores para la focalización de widgets de Encuestas/Feedback
Si planeas combinar activadores JavaScript con la focalización de atributos de usuario para widgets de encuestas o Feedback asegúrate que la llamada a API se haya producido antes que el activador en su orden de ejecución, teniendo en cuenta cualquier llamada asíncrona a otros servicios. Si el activador se ejecuta antes de que la llamada a la API de identificación haya terminado de ejecutarse, el widget de Encuesta/Feedback no se mostrará.
Puesta en cola de llamadas a la API antes de que Hotjar se haya cargado
Si este script se añade antes que el código de Hotjar, se producirá un error.
No se puede acceder al objeto hj() hasta que se haya ejecutado la etiqueta de código de Hotjar. Si por alguna razón accedes a la API de identificación antes de que se haya ejecutado el código de Hotjar, puedes añadir la siguiente línea de código antes de que se llame a la API:
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};Comprobación de atributos de usuario
Existen varias formas de comprobar que los atributos de usuario se envían correctamente a través de la API de identificación.
- Una vez que el código esté activo en tu página y haya sido activado al menos una vez, puedes visitar tu página de configuración de Atributos de Usuario para ver si el Atributo de Usuario está siendo capturado por Hotjaris activo en tu página.
- Para los usuarios de valor nulo, puede utilizar cualquier dirección de correo electrónico que posee para consentimiento para conectar Feedback a través de una Encuesta o Feedback. Esto te permitirá ver qué Atributos de Usuario están siendo pasados a usuarios no identificados, lo que es especialmente útil para comprobar que no estás enviando accidentalmente IIP a Hotjar. Es importante tener en cuenta que los usuarios que no han dado su consentimiento para conectar la retroalimentación no pueden ser buscados de esta manera, por lo que para fines de prueba, debe configurar un widget de retroalimentación para conceder el consentimiento con su propia dirección de correo electrónico.