El modo de depuración de Hotjar puede habilitarse en su navegador para solucionar problemas complejos y confirmar que Hotjar funciona correctamente. Este artículo explicará cómo habilitar el modo de depuración y compartirá algunos casos de uso común para hacerlo.
Cómo habilitar el modo de depuración a través de la URL
Añada el parámetro de depuración a la URL de su página
Para habilitar el modo de depuración, añada el siguiente parámetro URL al final de la página en la que está trabajando: ?hjDebug=1
Por ejemplo, para depurar https://www.hotjar.com/es/blog/, utilizaríamos esta URL: https: //www.hotjar.com/blog/?hjDebug=1
Abra las herramientas de desarrollo de su navegador
Estos son los pasos para abrir las herramientas de desarrollo en los siguientes navegadores:
- Chrome - en la barra de menús, haga clic en Ver > Desarrollador > Herramientas para desarrolladores
- Firefox en la barra de menús, haga clic en Herramientas > Herramientas del navegador > Herramientas para desarrolladores web
- Safari: en la barra de menús, haga clic en Desarrollo > Mostrar consola JavaScript.
Recargar la página
Al recargar la página, una vez completados los pasos anteriores, podrás ver todos los registros de depuración que se produjeron durante la carga de la página. Cuando aparezcan los registros de la consola, tendrán un aspecto similar al siguiente:
*Los registros de depuración son visibles en la pestaña Consola de las Herramientas de desarrollo de su navegador.
Cómo activar el modo de depuración con cookies
Abra las Herramientas para desarrolladores de su navegador
Estos son los pasos para abrir las herramientas de desarrollo en los siguientes navegadores:
- Chrome - en la barra de menús haz clic en Ver > Desarrollador > Herramientas de desarrollador
- Firefox en la barra de menús, haga clic en Herramientas > Herramientas del navegador > Herramientas para desarrolladores web
- Safari: en la barra de menús, haga clic en Desarrollo > Mostrar consola JavaScript.
Abrir la pestaña Aplicación
Abra sus cookies seleccionando la pestaña Aplicación.
Añada hjDebug como Cookie
Desplácese hasta la parte inferior de las cookies y haga doble clic en el espacio vacío. Luego escriba hjDebug en la columna Nombre.
Establezca cookie a true
En la segunda columna, escriba la palabra true para establecer la cookie, luego presione ENTER.
Recargar la página
Recargar la página, después de haber completado 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, tendrán un aspecto similar a estos:
Casos de uso
Los desarrolladores suelen utilizar el modo de depuración para probar eventos e identificar funciones de la API. Sin embargo, también se puede utilizar para ver si se cumplen los criterios de orientación y para ayudar a solucionar problemas por los que un widget de encuesta o de Feedback no aparece en una página. Esta sección compartirá algunos ejemplos de cómo funciona.
Buscar en la pestaña Consola para encontrar registros de depuración relevantes
Puede utilizar Ctrl+F (Windows) o command+F (Mac ) para buscar mensajes específicos en la pestaña Consola. Las capturas de pantalla siguientes 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 cuando un Evento Hotjar se ha disparado con éxito en el navegador. Cuando un evento se dispara con éxito, un mensaje de confirmación aparecerá en azul similar al último mensaje en la captura de pantalla de abajo:
COMANDO: Procesando comando: evento testEvent
Donde 'testEvent' representaría el nombre único del Evento que se está disparando.
Para activar esto manualmente, puede introducir lo siguiente directamente en la consola de su navegador:
hj('event', 'testEvent');
API de identificación
Cuando Hotjar reciba una llamada a la API de identificación, aparecerá un mensaje de confirmación en azul, similar a la imagen de ejemplo que se muestra a continuación:
COMANDO: Procesando comando: identify , {"userAttribute": "value"}
Donde "userAttribute" es el nombre del atributo recibido, y "value" es un valor asociado a ese atributo.
Puede enviar manualmente una llamada API a Hotjar introduciendo lo siguiente en la consola de su navegador:
hj('identificar', null, {
userAttribute: 'valor'
});
Además, puede ver los registros que indican si se han modificado o no los atributos buscando "attribute" en la ventana de la consola. Los resultados serán similares a los siguientes:
Surveys y Feedback
El modo de depuración puede ser útil para comprender el comportamiento de los widgets de Surveys y Feedback, ya que mostrará cuándo una herramienta ha coincidido con los criterios de destino, así como cuándo se muestra en la página.
Por ejemplo, buscar "encuesta" en la Consola puede permitirle encontrar mensajes relacionados con la herramienta Surveys. En el ejemplo siguiente, vemos que una encuesta específica (ID: 888238) ha coincidido con los criterios de destino en la página, y Hotjar ha llamado al sondeo (encuesta) para que aparezca en la página.
Del mismo modo, la búsqueda "feedback" en la Consola permite encontrar mensajes relacionados con la herramienta Feedback. En el ejemplo siguiente, vemos que un widget de feedback específico (ID: 14573) ha coincidido con los criterios de destino en la página, y Hotjar ha llamado al widget de feedback para que aparezca en la página.
¿Busca más información sobre un mensaje de registro de depuración específico?
Actualmente, no tenemos una guía de referencia para 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 dispongamos de más información. Si tienes algún problema para hacer funcionar las herramientas y características de Hotjar, por favor contacta con nuestro equipo de soporte usando el botón Contacta con nosotros debajo de este artículo.