Disponible para grabaciones y mapas de calor con Observe o planes
. Disponible para comentarios y encuestas con Ask
o planes
. Consulta la página de precios de Hotjar para conocer los planes y precios.
La API de Identificación de Hotjar te permite enviar datos sobre tus usuarios a Hotjar utilizando Javascript, guardándolos como Atributos de Usuario. Estos Atributos de Usuario pueden ser utilizados por Hotjar para habilitar filtros y segmentaciones avanzadas, brindándote información de calidad más rápido que antes. Puedes 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 grabaciones y dirigir encuestas y widgets de comentarios, así como para realizar solicitudes de búsqueda y eliminación de usuarios por ID de usuario.
Sigue los enlaces a continuación para obtener más información sobre los Atributos de Usuario:
- Visión general
- Manejo de IDs de usuario
- Realizar llamadas a Identify
- Valores de atributos de usuario
- Manejo de direcciones de correo electrónico
- Ejemplos de envío de Atributos de Usuario a Hotjar
- Uso de la API de Identificación de manera legalmente conforme
- Deshabilitar Atributos de Usuario
- Eliminar Atributos de Usuario
- Mejores prácticas
- Preguntas frecuentes
Puedes enviar Atributos de Usuario utilizando Google Tag Manager o Segment
Es posible comenzar a enviar Atributos de Usuario a Hotjar utilizando Google Tag Manager o Segment. Para obtener más detalles, consulta nuestro artículo Cómo enviar Atributos de Usuario con Google Tag Manager, o si estás utilizando Segment, visita nuestra guía Uso de Hotjar con Segment.
Visión general
Los Atributos de Usuario son valores de datos sobre los usuarios de tu sitio que se envían 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 Seguimiento de Hotjar.
Estos datos se envían a Hotjar en pares clave-valor como una llamada AJAX asíncrona a los servidores de Hotjar. Estos valores están asociados con un ID de usuario, un valor único identificable 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 recopilados sobre ellos con el mismo ID de usuario que utiliza en su propia base de datos, así como buscar información de usuario que Hotjar tenga sobre ese usuario.
Hay 4 fases en el proceso de enviar Atributos de Usuario y utilizarlos con Hotjar.
- Obtener los datos de su sitio.
- Pasar los datos a Hotjar a través de la API de Identificación.
- Hotjar almacena los datos de cada usuario como Atributos de Usuario asociados a su user_id.
- Ahora puede utilizar las herramientas de Hotjar para dirigirse y filtrar por Atributos de Usuario.
Realizar llamadas a Identificar
Antes de poder comenzar a realizar llamadas a Identificar, los Atributos de Usuario deben estar habilitados en la configuración de Hotjar para cada sitio en el que desee utilizar Atributos de Usuario.
Habilitar y deshabilitar Atributos de Usuario
La capacidad de acceder a la API de Identificar y a los Atributos de Usuario se habilitará de forma predeterminada si esta función está incluida en su plan de Hotjar. Sin embargo, si los Atributos de Usuario estuvieron deshabilitados en el pasado, es posible que deba habilitarlos nuevamente para su uso.
En su página de Atributos de Usuario (Configuración > Atributos de Usuario), busque el Sitio al que desea agregar Atributos de Usuario utilizando el menú desplegable de selección. Verá algo como esto que muestra el estado de su implementación de Atributos de Usuario:
También puede deshabilitar 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 que haya hecho esto, las llamadas posteriores a la API serán bloqueadas. El botón "Deshabilitar Atributos de Usuario" solo aparecerá después de que Hotjar haya recibido datos de atributos de usuario, pero no antes.
Se desactivarán cualquier informe que dependa de los Atributos de Usuario para fines de segmentación, y no podrá volver a habilitarlos a menos que cambie sus opciones de segmentación o vuelva a habilitar los Atributos de Usuario.
Si desea evitar que se envíen Atributos de Usuario en el futuro, debe eliminar el código de la API de Identificar de su sitio. Una vez que se haya eliminado el código de su sitio, los Atributos de Usuario recopilados anteriormente seguirán existiendo, pero ya no se actualizarán ni se agregarán a los nuevos usuarios de su sitio.
La llamada a la API
Aquí está el formato para una llamada a la API de Identificar:
hj('identify', userId, {
user_attribute: value
});
- El primer parámetro siempre debe contener 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 pasados a esta llamada deben provenir de la base de código de su propio sitio. Estos valores pueden extraerse directamente de sus servidores o generarse en el lado del 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 realiza una llamada a Identify, los valores almacenados en los servidores de Hotjar se reemplazarán con los valores más recientes para estos atributos.
Puedes buscar todos los atributos enviados a Hotjar en la página de configuración de Atributos de Usuario. Puedes utilizar la función de Búsqueda de Usuario para inspeccionar qué valores se han pasado para un usuario específico en tu sitio.
Mientras un usuario esté identificado durante su sesión, Hotjar puede asociar tanto los ID de Usuario como los Atributos de Usuario con la Grabación de una sesión y ofrecer una segmentación precisa del widget de Feedback, lo que te permite recopilar comentarios específicos de usuarios utilizando Feedback y Encuestas. Por ejemplo: "Quiero que esta Encuesta se dirija solo a los clientes que han realizado una compra hace más de 10 días".
Las grabaciones se guardarán con los valores más recientes enviados a Hotjar durante la sesión.
Si envías múltiples 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 manera consistente con cada llamada, lo que permite a Hotjar conectar una Grabación con un usuario específico.
Manejo de los ID de Usuario
El segundo argumento pasado a Hotjar a través de la llamada a la API de Identify debe ser un ID de usuario único e identificable de 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 en sí mismo. También debe ser un valor que nunca cambie para este usuario. Una vez que hayas establecido un ID de Usuario en Hotjar, no se puede cambiar. Si cambia, Hotjar lo considerará como un usuario totalmente nuevo.
Si se conoce un ID de Usuario, el ID de 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 de 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 Identify con un ID de Usuario.
Es útil trabajar esto con un ejemplo.
Supongamos que tenemos una usuaria, Rachel. Ella visita el sitio 3 veces en 2 dispositivos diferentes.
-
Sesión A - Rachel visita radbooks.com en su tablet.
- Ella no es una usuaria del sitio todavía y se le asigna un ID de Hotjar de 123
-
Sesión B - Rachel luego visita en su móvil.
- Ella no es una usuaria todavía y se le asigna un ID de Hotjar de 456
-
Sesión C - Rachel vuelve al sitio desde su móvil.
- Hotjar la reconoce con el ID de Hotjar de 456.
- Luego ella registra una cuenta.
- Tu llamada a Identify le asigna un ID de Usuario de ABC, utilizando el mismo ID de Usuario que tienes para ella en tu base de datos.
Debido a que la hemos asociado con un ID de Usuario en tu sitio, luego conectamos todos los datos asociados con el ID de Hotjar 456 con su ID de Usuario ABC, aunque no haya iniciado sesión durante la Sesión B.
Si Rachel luego visita el sitio en su tablet en una cuarta sesión, y esta vez inicia sesión, Hotjar unirá los datos de la Sesión A con la Sesión B y C, dándote una imagen completa de sus interacciones con tu sitio.
¿Qué pasa si no tienes un ID de Usuario?
Si no se conoce el ID de usuario, debes pasar un valor nulo como segundo parámetro. Cuando hagas esto, cualquier atributo de usuario pasado a la API de Identificar se asociará con el ID de Hotjar del usuario en su lugar.
No pases información de identificación personal como atributo de usuario sin un ID de usuario
Si no se conoce un ID de usuario (pasando un valor nulo), entonces cualquier otro atributo de usuario pasado a Hotjar no debe contener información de identificación personal (PII). Tu capacidad para buscar atributos de usuario asociados con un usuario individual en Hotjar depende de tu capacidad para buscar su ID de usuario. Hotjar no tiene forma de recuperar o eliminar estos datos a menos que elimines todo el sitio en Hotjar.
Valores de atributos de usuario
Puedes pasar los siguientes valores a una clave de atributo de usuario utilizando la API de Identificar. En este momento, no se pueden utilizar caracteres especiales.
Manejo de direcciones de correo electrónico
En la actualidad, hay 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 algún otro atributo de usuario de tipo cadena contiene una dirección de correo electrónico, estos serán rechazados, lo que significa que solo debes usar `email` para pasar direcciones de correo electrónico.
Direcciones de correo electrónico e ID de usuario
El ID de usuario puede tomar la forma de direcciones de correo electrónico, por lo que si la clave primaria de tu base de datos para los usuarios es su dirección de correo electrónico, esto se puede utilizar como un ID de usuario. Esto solo debe usarse como último recurso. Si la clave primaria de un usuario en tu base de datos existe de otra forma que no sea un correo electrónico, debes usar esa clave.
Debido a que las direcciones de correo electrónico generalmente pueden cambiar, si se actualiza su dirección de correo electrónico, Hotjar tratará a ese usuario como un usuario totalmente diferente. Esto evitaría que uses la Búsqueda de usuario en la dirección de correo electrónico anterior, lo que podría incumplir tus requisitos de privacidad.
Ejemplos de pasar atributos de usuario a Hotjar
Identificar clientes que pagan
Aquí tienes un ejemplo, donde queremos decirle a Hotjar cuánto dinero ha gastado alguien en tu sitio.
hj('identify', userId, {
total_spend: 500
});
Se pueden pasar varios atributos agregando 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 utilizando una cadena de fecha ISO8601.
Identificar atributos para usuarios anónimos
A veces es útil rastrear información sobre los usuarios en tu sitio, incluso si aún no son usuarios o clientes que pagan. Digamos que quieres rastrear la fuente de referencia y la variante de prueba A-B de la página de destino a la que llegó un posible cliente:
hj('identify', null, {
ab_test: 'variante-A',
referrer: 'facebook_pagado'
});
Esto sería útil si quisieras dirigir una encuesta a los usuarios de la variante-A, o solo a aquellos que llegaron a ti desde anuncios pagados de Facebook, por ejemplo.
Uso del API de Identificación de manera legalmente conforme
El API de Identificación está desactivado de forma predeterminada, lo que facilita evitar capturar información personal por accidente hasta que hayas abordado adecuadamente las preocupaciones de privacidad. Al habilitar los Atributos de Usuario, es posible que estés enviando los datos personales de tus usuarios finales a Hotjar. Requerimos que reconozcas tus obligaciones legales al hacerlo y aceptes el Acuerdo de Procesamiento de Datos de Hotjar.
Es tu responsabilidad utilizar esta función de manera legalmente conforme, de acuerdo con las leyes de tu país y los países que visitan tus usuarios. Visita nuestra página de privacidad para obtener más información sobre el enfoque de Hotjar respecto a la privacidad del usuario. Al utilizar los Atributos de Usuario, debes tener en cuenta y cumplir con los Términos 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 eliminar los datos de un usuario utilizando su ID de usuario. Lee más sobre esto en nuestro artículo "Cómo utilizar la búsqueda de usuarios". Es importante tener en cuenta que si conoces el ID de usuario de un usuario y su dirección de correo electrónico, debes buscar su información con ambos. Esta es la única forma de asegurarte de que se haya buscado y eliminado toda la información personal que Hotjar tiene sobre este usuario.
Desactivación de los Atributos de Usuario
Para evitar que se envíen más Atributos de Usuario a Hotjar, debes desactivar los Atributos de Usuario.
Mientras los Atributos de Usuario estén habilitados en tu sitio, si deseas 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 se haya eliminado el código de tu sitio, los Atributos de Usuario recopilados anteriormente seguirán existiendo, pero ya no se actualizarán ni se agregarán a los nuevos usuarios de tu sitio.
Eliminación de los Atributos de Usuario
Los Atributos de Usuario se pueden eliminar desde la página de gestión de Atributos de Usuario haciendo clic en el icono de la papelera a la derecha del atributo. Solo los miembros del equipo con permisos de 'Lectura y escritura' o superiores pueden eliminar los Atributos de Usuario.
Cuando se elimina un atributo, desaparecerá inmediatamente de la aplicación de Hotjar. Sin embargo, el atributo aún se almacena en el backend durante 7 días antes de eliminarse permanentemente. Los datos asociados con el atributo se ignoran durante el período de 7 días. Esto se hace para evitar que se envíen datos debido a problemas de caché.
Si deseas volver a crear un atributo que se haya eliminado, deberás esperar 7 días antes de que el atributo se pueda crear nuevamente correctamente.
Asegúrate de eliminar cualquier Atributo de Usuario eliminado de todas las llamadas de la API de Identificación
Eliminar un Atributo de Usuario no lo eliminará de ninguna sesión existente o respuestas que lo contengan. El atributo solo se eliminará de los filtros y la segmentación. Recuerda eliminar el Atributo de Usuario eliminado de todas las llamadas de la API de Identificación, de lo contrario, volverá a aparecer en la lista.
Mejores prácticas
Cuándo hacer llamadas a la API de Identificación
Debes hacer llamadas a la API de Identificación cada vez que:
- Se carga una página con los valores más recientes (incluso si no han cambiado).
- Después de un cambio de URL en aplicaciones de una sola página.
- Cada vez que se realiza un cambio. Por ejemplo, si deseas rastrear la última compra de un usuario en una tienda, debes actualizar este atributo de usuario una vez que se haya realizado la compra.
Cada llamada actualizará los Atributos de Usuario en Hotjar con los valores más recientes. Cuando una grabación de sesión finaliza, 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 se han actualizado, la solicitud de red no se enviará para evitar solicitudes AJAX innecesarias.
Combinar llamadas a la API de Identificación con disparadores para segmentar encuestas/widgets de comentarios
Si planeas combinar disparadores de JavaScript con la segmentación de Atributos de Usuario para encuestas o widgets de comentarios, debes asegurarte de que la llamada de Identificación haya ocurrido antes del disparador en tu orden de ejecución, teniendo en cuenta cualquier llamada asíncrona a otros servicios. Si el disparador se ejecuta antes de que la llamada a la API de Identificación haya finalizado, la encuesta/widget de comentarios no se mostrará.
Cola de llamadas a la API antes de que Hotjar se haya cargado
Si este script se agrega antes de tu 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 accedes a la API de Identificación antes de que se haya ejecutado el código de seguimiento, puedes agregar la siguiente línea de código antes de llamar a la API:
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};
Pruebas de Atributos de Usuario
Existen algunas formas de probar si los Atributos de Usuario se envían correctamente a través de la API de Identificación.
- Una vez que el código está en vivo en tu página y se ha activado al menos una vez, puedes visitar la página de configuración de tus Atributos de Usuario para ver si el Atributo de Usuario capturado por Hotjar está activo en tu página.
- Puedes habilitar el modo de depuración de Hotjar en tu navegador para ver si las llamadas a la API de Identificación se envían correctamente a Hotjar durante tu sesión.
- Para usuarios con valor nulo, puedes utilizar cualquier dirección de correo electrónico que poseas para dar consentimiento para conectar Feedback a través de una encuesta o comentarios. Esto te permitirá ver qué Atributos de Usuario se están enviando a usuarios no identificados, lo cual es especialmente útil para verificar que no estés enviando accidentalmente información de identificación personal a Hotjar. Es importante tener en cuenta que los usuarios que no han dado su consentimiento para conectar Feedback no se pueden buscar de esta manera, por lo que, con fines de prueba, debes configurar un widget de comentarios para otorgar consentimiento con tu propia dirección de correo electrónico.