CheckealosUX

### Extension Name CheckealosUX ### Description Professional tool for quantitative usability studies and interaction analysis on web prototypes. Automatically records user events (clicks, keystrokes, navigation, context) on prototype URLs, securely sending data for analysis and report generation. Fully compliant with Chrome Web Store privacy and security policies. #### Key Benefits - Automates user event tracking on web prototypes. - Enables quantitative UX studies without modifying the prototype. - Allows comparison of variants and analysis of different elements' performance (A/B testing). - Data is securely sent for analysis and report generation. - Full cleanup of data and scripts after each session. - Compatible with Chrome and Edge. #### Suggested Keywords usability, UX, prototypes, tracking, analytics, A/B testing, user experience, studies, interaction, privacy #### Suggested Category Productivity / Developer Tools #### Main Language English #### Promotional Text Optimize your prototypes and make decisions based on real user interaction data. --- # What’s New in 1.2.0 / Novedades en 1.2.0 Fecha: 2025-11-19 Versión: 1.2.0 --- ## English ### Summary - Increased reliability when starting and finishing quantitative task-based studies in SPA flows (no full page reloads). - Added a global, robust detection of task start/end buttons (`chk-start-task-*` / `complete-task-*`). - Improved logging around task configuration, storage state and API sending to ease debugging. - No new permissions or data categories; scope remains unchanged. ### Details #### Robust task button detection - The content script now registers a **single global click listener** that: - Detects clicks on elements whose `id` starts with `chk-start-task-` or `complete-task-`, even if they are created dynamically by the host application (SurveyJS/SPA). - Reuses the same logic used by the per-button listeners to: - Read `data-task-id`, `data-sampler-study-id` and `data-domain`. - Store the configuration in `chrome.storage.local`. - Inject or update the tracker script and send `TRACKING_CONFIG_INIT`. - This makes the tracker independent from the exact moment when the task UI is rendered, avoiding missed initializations when there is no full page reload. #### Logging and diagnostics - Added explicit logs in the task button module to make the lifecycle visible: - When a start/end button is wired with a direct listener. - When a click is detected by the **global** listener. - When task data is stored (`taskId`, `samplerStudyId`, `domain`) or missing. - When storage updates or API calls fail. - These logs are prefixed consistently (e.g. `[taskButtons]`, `[trackingManager]`) to simplify filtering in DevTools. #### Integration with existing handshake - The new button handling logic plugs into the existing handshake introduced in 1.1.0: - Once the task configuration is stored, the tracking manager can respond to `CHECKEALOSUX_REQUEST_CONFIG` from `tracker.js` and send `TRACKING_CONFIG_INIT` reliably. - This ensures that `__CHECKEALOSUX_TRACKING_ACTIVE__` becomes `true` in the prototype even in complex navigation flows. ### Privacy & Permissions - No changes in requested permissions. - No new data categories are collected; only task events (clicks, keys, URL changes) within the previously declared host permissions. --- ## Español ### Resumen - Mayor fiabilidad al iniciar y finalizar tareas cuantitativas en flujos tipo SPA (sin recarga completa de página). - Detección global y robusta de los botones de inicio y fin de tarea (`chk-start-task-*` / `complete-task-*`). - Logging mejorado sobre la configuración de la tarea, el estado de almacenamiento y el envío a la API para facilitar el debugging. - Sin nuevos permisos ni nuevas categorías de datos; el alcance sigue siendo el mismo. ### Detalle #### Detección robusta de botones de tarea - El content script ahora registra **un único listener global de clic** que: - Detecta clics en elementos cuyo `id` empieza por `chk-start-task-` o `complete-task-`, incluso si se crean dinámicamente por la aplicación anfitriona (SurveyJS/SPA). - Reutiliza la misma lógica que los listeners por botón para: - Leer `data-task-id`, `data-sampler-study-id` y `data-domain`. - Guardar la configuración en `chrome.storage.local`. - Inyectar o actualizar el script de tracking y enviar `TRACKING_CONFIG_INIT`. - Esto hace que el tracker sea independiente del momento exacto en que se renderiza la UI de la tarea, evitando inicializaciones perdidas cuando no hay recarga completa. #### Logging y diagnóstico - Se añaden logs explícitos en el módulo de botones de tarea para hacer visible el ciclo de vida: - Cuando un botón de inicio/fin se cablea con un listener directo. - Cuando el listener **global** detecta un clic. - Cuando se almacenan los datos de la tarea (`taskId`, `samplerStudyId`, `domain`) o faltan. - Cuando fallan actualizaciones de storage o llamadas a la API. - Estos logs se prefijan de forma consistente (por ejemplo, `[taskButtons]`, `[trackingManager]`) para facilitar el filtrado en DevTools. #### Integración con el handshake existente - La nueva gestión de botones se integra con el handshake introducido en la versión 1.1.0: - Una vez que la configuración de la tarea está en storage, el gestor de tracking puede responder a `CHECKEALOSUX_REQUEST_CONFIG` desde `tracker.js` y enviar `TRACKING_CONFIG_INIT` de forma fiable. - Esto garantiza que `__CHECKEALOSUX_TRACKING_ACTIVE__` pase a `true` en el prototipo incluso en flujos de navegación complejos. ### Privacidad y Permisos - No hay cambios en los permisos solicitados. - No se añaden nuevas categorías de datos; solo se siguen recogiendo eventos de tarea (clics, teclas, cambios de URL) dentro de los dominios ya declarados en `host_permissions`. --- ### Notas para la ficha de Chrome Web Store - English: "Improved robustness of task start/end detection in SPA flows and added be…