CheckealosUX

Join studies and earn rewards for your interactions in usability tasks.

### 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 better diagnostics. No new permissions or data categories." - Español: "Mayor robustez en la detección de inicio/fin de tarea en flujos SPA y mejor diagnóstico. Sin nuevos permisos ni categorías de datos." # What’s New / Novedades Fecha: 2025-11-11 Versión: 1.1.0 --- ## English ### Summary - Improved activation reliability for the tracking script on heavy/embedded prototypes. - Introduced a safe handshake (CHECKEALOSUX_READY) and a config buffer with controlled retries to avoid race conditions. - Added proactive config request from the tracker when INIT doesn’t arrive in time. - Added timeouts and robust cleanup to prevent dangling timers. - No new permissions or data categories; scope unchanged. ### Details - Handshake and buffering: - The content-side manager only sends TRACKING_CONFIG_INIT after the tracker declares readiness. - If configuration isn’t available yet (IDs not in storage), the manager actively waits (short polling with timeout) and sends once available. - If INIT doesn’t arrive fast enough, the tracker requests it (CHECKEALOSUX_REQUEST_CONFIG). - Cleanup and safety: - All timers (READY wait, config wait, resend) are cleared on stop. - Added a READY timeout to avoid indefinite waits. - Frames: - content_scripts run with `all_frames: true` to support embedded prototypes within matching domains; this is not an extra permission. ### Privacy & Permissions - No change in permissions or data categories. - Execution in iframes is limited to matching host permissions. --- ## Español ### Resumen - Mayor fiabilidad en la activación del tracking en prototipos pesados/embebidos. - Handshake seguro (CHECKEALOSUX_READY) y búfer de configuración con reintentos controlados para evitar carreras. - Solicitud proactiva de configuración desde el tracker cuando INIT tarda en llegar. - Timeouts y limpieza robusta para evitar temporizadores colgando. - Sin nuevos permisos ni categorías de datos; el alcance no cambia. ### Detalle - Handshake y buffering: - El gestor del lado de contenido envía TRACKING_CONFIG_INIT solo cuando el tracker declara que está listo. - Si la configuración aún no está disponible (IDs en storage), el gestor espera activamente (polling corto con timeout) y envía cuando esté. - Si INIT no llega a tiempo, el tracker lo solicita (CHECKEALOSUX_REQUEST_CONFIG). - Limpieza y seguridad: - Todos los temporizadores (espera de READY, espera de config, reintentos) se limpian al detener. - Se agrega timeout de READY para evitar esperas indefinidas. - Frames: - Los content_scripts se ejecutan con `all_frames: true` para soportar prototipos embebidos en dominios coincidentes; no es un permiso adicional. ### Privacidad y Permisos - No hay cambios en permisos ni en categorías de datos. - La ejecución en iframes se limita a los dominios declarados en host_permissions. --- ### Notes for Chrome Web Store Listing / Notas para la ficha en la Web Store - English: “Improved activation reliability via handshake and controlled retries. No new permissions or data categories.” - Español: “Mejora de fiabilidad en la activación mediante handshake y reintentos controlados. Sin nuevos permisos ni categorías de datos.”