Disponible para Recordings y Heatmaps con los planes Observe 
o 
. Disponible para Feedback y Surveys con los planes Ask o . Consulte la página de precios de Hotjar para conocer los planes y precios.
La API Identify de Hotjar te permite pasar datos sobre tus usuarios a Hotjar usando Javascript, guardándolos como Atributos de Usuario. Estos atributos de usuario pueden ser utilizados por Hotjar para permitir el filtrado avanzado y la segmentación, que le da información de calidad más rápido que antes. Puede enviar hasta 100 atributos de usuario en cualquier sitio, con cualquier número de usuarios asociados a esos atributos.
Los atributos de usuario se pueden utilizar para filtrar Recordings y segmentar Surveys y widgets de Feedback, así como para realizar búsquedas de usuarios y solicitudes de eliminación por ID de usuario.
Siga los siguientes enlaces para obtener más información sobre los atributos de usuario:
- Visión general
- Gestión de ID de usuario
- Llamadas para identificar
- Valores de atributos de usuario
- Manejo de direcciones de correo electrónico
- Ejemplos de transmisión de atributos de usuario a Hotjar
- Uso de la API Identify 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, o si estás usando Segment visita nuestra guía Usando Hotjar con Segment.
Visión general
Los Atributos de Usuario son valores de datos sobre los usuarios de su sitio pasados a Hotjar desde su 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 seguimiento 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 a 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 que Hotjar tiene sobre ese usuario.
Hay 4 fases en el proceso de enviar atributos de usuario y utilizarlos con Hotjar.
- Obtén 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 Identify
Antes de que puedas empezar a hacer llamadas 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 Identify 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 haya seleccionado un Sitio con Atributos de Usuario habilitados, haga 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 su 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 su sitio.
La llamada a la API
Este es el formato de una llamada a la API Identify:
hj('identificar', userId, {
atributo_usuario: valor
});
- 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 su sitio, de su 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 su 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 su 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 Surveys. Por ejemplo: "Quiero que esta encuesta se dirija sólo 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 su 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 se conoce un ID de usuario, el ID Hotjar 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.
Es útil trabajar esto con 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.
- A continuación, registra una cuenta.
- Su llamada a 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 su 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 su sitio.
¿Qué pasa si no tienes un ID de usuario?
Si no se conoce el ID de usuario, entonces debe 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 pase 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
Puede pasar los siguientes valores a una clave de Atributo de Usuario utilizando la API Identify. Los caracteres especiales no se pueden utilizar 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('identificar', 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 le impediría utilizar la Búsqueda de Usuarios en la dirección de correo electrónico anterior, lo que podría 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 su sitio.
hj('identificar', userId, {
gasto_total: 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('identificar', userId, {
gasto_total: 500,
primera_compra: '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 su 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('identificar', 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 de forma legal
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 que aceptes el Acuerdo de Procesamiento de Datos de Hotjar.
Es su responsabilidad utilizar esta función de una manera legalmente compatible, de acuerdo con las leyes de su país y de los países que visitan sus usuarios. Visite 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, debes 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 de usuario".. Es importante tener en cuenta que si conoces el ID de usuario y la dirección de correo electrónico de un usuario, debes buscar su información con 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, debes 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 sea eliminado de tu sitio, los Atributos de Usuario previamente recopilados 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úrese de eliminar cualquier atributo de usuario eliminado de todas las llamadas a la API de Identify.
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 orientació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 Identify
Debería 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 orientación de widgets de Surveys/retroalimentación
Si planea combinar activadores JavaScript con la segmentación por atributos de usuario para widgets de Surveys o Feedback, debe asegurarse de que la llamada a Identify 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 finalizado, el widget de encuesta/opinión 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 seguimiento de Hotjar, se producirá un error.
No se puede acceder al objeto hj() hasta que se haya ejecutado la etiqueta de código de seguimiento de Hotjar. Si por alguna razón accede a la API de Identify antes de que se haya ejecutado el código de seguimiento, puede 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 si los atributos de usuario se envían correctamente a través de la API de Identify.
- 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 capturado por Hotjar está activo en tu página.
- Puede activar el modo de depuración de Hotjar en su navegador para ver si las llamadas a la API de identificación se están enviando a Hotjar correctamente durante su sesión.
- Para los usuarios de valor nulo, puede utilizar cualquier dirección de correo electrónico que posea para dar su consentimiento para conectar Feedback a través de una Encuesta o Feedback. Esto le permitirá ver qué Atributos de Usuario están siendo pasados a usuarios no identificados, lo que es especialmente útil para comprobar que no está enviando accidentalmente PII 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.