El modo de depuración de Hotjar se puede habilitar en tu navegador para solucionar problemas complejos y confirmar que Hotjar está funcionando correctamente. Este artículo explicará cómo habilitar el modo de depuración, compartir algunos casos de uso comunes y proporcionar información sobre mensajes de registro de depuración específicos.
Sigue desplazándote o haz clic en una de las secciones a continuación para obtener más información:
- Cómo habilitar el modo de depuración a través de la URL
- Cómo habilitar el modo de depuración con cookies
- Casos de uso
- Guía de referencia de mensajes de registro
Cómo habilitar el modo de depuración a través de la URL
Agrega el parámetro de depuración a la URL de tu página
La habilitación del modo de depuración se realiza agregando el siguiente parámetro de URL al final de la página en la que estás trabajando: ?hjDebug=1
Por ejemplo, para depurar https://www.hotjar.com/blog/, usaríamos esta URL en su lugar: https://www.hotjar.com/blog/?hjDebug=1
Abre las Herramientas de Desarrollo de tu navegador
Aquí están los pasos para abrir las herramientas de desarrollo en los siguientes navegadores:
- Chrome - en la barra de menú haz clic en Ver > Desarrollador > Herramientas de Desarrollo
- Firefox - en la barra de menú haz clic en Herramientas > Herramientas del navegador > Herramientas de Desarrollo Web
- Safari - en la barra de menú haz clic en Desarrollar > Mostrar Consola de JavaScript
Recarga la página
Recargar la página, después de completar los pasos anteriores, asegurará que puedas ver todos los registros de depuración que ocurrieron durante la carga de la página. Cuando aparezcan los registros de la Consola, se verán similares a estos:
*Los registros de depuración son visibles en la pestaña de Consola de las Herramientas de Desarrollo de tu navegador.
Cómo habilitar el modo de depuración con cookies
Abre las Herramientas de Desarrollo de tu navegador
Aquí están los pasos para abrir las herramientas de desarrollo en los siguientes navegadores:
- Chrome - en la barra de menú haz clic en Ver > Desarrollador > Herramientas de desarrollador
- Firefox - en la barra de menú haz clic en Herramientas > Herramientas del navegador > Herramientas de desarrollo web
- Safari - en la barra de menú haz clic en Desarrollar > Mostrar consola de JavaScript
Abre la pestaña de Aplicación
Abre tus cookies seleccionando la pestaña de Aplicación.
Agrega hjDebug como una Cookie
Desplázate hasta el final de las cookies y haz doble clic en el espacio vacío. Luego escribe hjDebug en la columna de Nombre.
Establece la cookie en true
En la segunda columna, escribe la palabra true para establecer la cookie, luego presiona ENTER.
Recarga la página
Recargar la página, después de completar los pasos anteriores, asegurará que puedas ver todos los registros de depuración que ocurrieron durante la carga de la página. Cuando aparezcan los registros de la Consola, se verán similares a estos:
Casos de uso
El modo de depuración se utiliza con frecuencia por los desarrolladores para probar Eventos y funciones de Identificación de API. Sin embargo, también se puede utilizar para ver si se cumplen los criterios de segmentación y para ayudar a solucionar por qué un widget de Encuesta o Comentarios no aparece en una página. Esta sección compartirá algunos ejemplos de cómo funciona.
Buscar en la pestaña de Consola para encontrar registros de depuración relevantes
Puedes usar Ctrl+F (Windows) o command+F (Mac) para buscar en la pestaña de Consola mensajes específicos. Las capturas de pantalla a continuación muestran ejemplos de términos de búsqueda que se utilizaron para reducir el número de entradas de registro visibles en la Consola del navegador.
API de Eventos
Los registros de depuración mostrarán cuándo se ha enviado con éxito un Evento de Hotjar en el navegador. Cuando un evento se envía correctamente, aparecerá un mensaje de confirmación en azul similar al último mensaje en la captura de pantalla a continuación:
COMANDO: Procesando comando: evento testEvent
Donde 'testEvent' representaría el nombre único del Evento que se está activando.
Para activar esto manualmente, puedes ingresar lo siguiente directamente en la Consola de tu navegador:
hj('event', 'testEvent');
Identificar API
Cuando Hotjar recibe una llamada de la API de Identificar, aparecerá un mensaje de confirmación en azul, similar a la imagen de ejemplo a continuación:
COMANDO: Procesando comando: identificar , {"atributoUsuario":"valor"}
Donde "atributoUsuario" es el nombre del atributo recibido, y "valor" es un valor asociado con ese atributo.
Puedes enviar manualmente una llamada de API a Hotjar ingresando lo siguiente en la Consola de tu navegador:
hj('identify', null, {
atributoUsuario: 'valor'
});
Además, puedes ver registros que indiquen si los atributos han sido cambiados buscando "atributo" en la ventana de la Consola. Los resultados se verán similares a esto:
Encuestas y Retroalimentación
El modo de depuración puede ser útil para comprender el comportamiento de las herramientas de Encuestas y Retroalimentación, ya que mostrará cuándo una herramienta ha cumplido con los criterios de destino, así como cuándo se renderiza en la página.
Por ejemplo, buscar "encuesta" en la Consola te permitirá encontrar mensajes relacionados con la herramienta de Encuestas. En el ejemplo a continuación, vemos que una encuesta específica (ID: 888238) ha cumplido con los criterios de destino en la página, y Hotjar ha llamado a la encuesta para que aparezca en la página.
De manera similar, buscar "retroalimentación" en la Consola te permite encontrar mensajes relacionados con la herramienta de Retroalimentación. En el ejemplo a continuación, vemos que un widget de retroalimentación específico (ID: 14573) ha cumplido con los criterios de destino en la página, y Hotjar ha llamado al widget de retroalimentación para que aparezca en la página.
Guía de referencia de mensajes de registro
Actualmente, no tenemos una lista completa de todos los posibles mensajes de registro de depuración. Sin embargo, esto es algo que nuestro equipo explorará en el futuro y actualizaremos este documento a medida que se disponga de más información. Si tienes problemas para hacer funcionar las herramientas y funciones de Hotjar, por favor ponte en contacto con nuestro equipo de soporte utilizando el botón Contacta con nosotros que se encuentra debajo de este artículo.
Errores de Política de Seguridad de Contenido
Si notas algún error que mencione dominios de Hotjar (hotjar.com, hotjar.io, etc.) y se relacione con "Política de Seguridad de Contenido", asegúrate de consultar este artículo para conocer los pasos sobre cómo resolverlos.
La siguiente tabla contiene algunos mensajes comunes de registro de depuración de Hotjar que podrías encontrar al usar Hotjar en tu sitio web:
Registros de captura de sesión
Mensaje de registro | Significado |
WEBSOCKET: Conexión al Web Socket [wss://wsp4.hotjar.com/api/v2/client/ws] | Hotjar está intentando abrir un Web Socket en la página. |
WEBSOCKET: Web Socket abierto. | Confirmación de que el Web Socket se abrió correctamente. |
WEBSOCKET: Enviando datos al Web Socket: | Confirmación de que el Web Socket está recibiendo datos de la página. Esto es necesario para que los datos de sesión sean capturados por las Grabaciones y Mapas de calor. |
Atributos de usuario y registros de eventos
Mensaje de registro | Significado |
COMANDO: Procesando comando: identificar , {"atributoDeUsuario":"valor"} | Se detectó una llamada de la API de Identificar. En el mensaje de ejemplo a la izquierda, se envió un atributo de usuario llamado atributoDeUsuario con un valor de valor. |
ATRIBUTOSDEUSUARIO: No hay grabación en curso. No se está enviando. | Se detectó una llamada de la API de Identificar, pero la sesión del usuario no está siendo rastreada por Hotjar. Esto puede ocurrir cuando tu sitio está experimentando Muestreo. |
COMANDO: Comando "identificar" bloqueado debido a la exclusión voluntaria | Este mensaje suele estar relacionado con la configuración de No rastrear (DNT) del navegador. Si DNT está habilitado, Hotjar descartará todos los Atributos de usuario para la sesión. |
ATRIBUTOSDEUSUARIO: Atributos de usuario enviados por websocket.: (Expandir para ver atributos) | Se detectaron Atributos de usuario y se están enviando a los servidores de Hotjar. |
ATRIBUTOSDEUSUARIO: Falló la llamada de validación de Atributos de usuario.: | La llamada a la API de Identificar falló, expande el mensaje para ver la razón. Por ejemplo: "El usuario no tiene user_id o atributos". |
COMANDO: Procesando comando: evento nombre_de_acción | Se disparó un Evento de Hotjar en la página. En el mensaje de ejemplo a la izquierda, el nombre del evento fue nombre_de_acción. |
Registros de encuestas y comentarios
Mensaje de registro | Significado |
ENCUESTA: La encuesta n.º xxxx coincidió. | Una encuesta en la página coincidió con los criterios de segmentación. El número xxxx se refiere al ID de la encuesta dentro de Hotjar. Varios elementos podrían coincidir en la misma página. |
RENDERIZACIÓN: Llamando al elemento activo (encuesta): x | Hotjar está iniciando una encuesta coincidente para que aparezca en la página. El valor de x será inmediato, demora, abandono o desplazamiento según la configuración de comportamiento de la encuesta. |
ENCUESTA: Renderizando widget de encuesta. | La encuesta debería ser visible en la página en vivo. |
RETROALIMENTACIÓN: El widget de retroalimentación n.º xxxx coincidió. | Un widget de retroalimentación en la página coincidió con los criterios de segmentación. El número xxxx se refiere al ID del widget dentro de Hotjar. Varios elementos podrían coincidir en la misma página. |
RENDERIZACIÓN: Llamando al elemento activo (retroalimentación): x | Hotjar está iniciando un widget de retroalimentación coincidente para que aparezca en la página. El valor de x será inmediato o demora según la configuración de comportamiento del widget de retroalimentación. |
RENDERIZACIÓN: Llamando al elemento activo (retroalimentación): inmediato | Hotjar está llamando a un widget de retroalimentación coincidente para que aparezca en la página. |
ENCUESTA: La encuesta ya fue enviada. | La encuesta coincidió con los criterios de segmentación, pero está configurada para no aparecer nuevamente después de que el usuario ya haya respondido. |