labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • COMMENCER

      • Éditeur de Tâches
      • Cadres
        • Cadre de Canvas
        • Cadre de Page
        • Cadre de Site Web
      • Chronologie des Essais
      • Présentation des Stimuli
      • Correction de la Réponse
      • Objets
      • Événements
      • Variables
      • Assistant de Tâche
      • Système d'Essai
      • Conception de l'Expérience
        • Créer une étude
        • Modèles de Data Frame
        • Conception d'expériences multi-utilisateurs
        • Conception d'Expérience Longitudinale
    • SUJETS EN VEDETTE

      • Randomisation & Équilibre
      • Suivi Oculaire
        • Présentation des Stimuli dans une Tâche de Suivi Oculaire
        • Comment Choisir les Paramètres de Calibration du Suivi Oculaire
        • Configurer le suivi oculaire dans une tâche
        • Enregistrement et exportation des données de regard
        • Utiliser des formes comme zones d'intérêt (AOI) pour le suivi oculaire
        • L'expérience de calibration des participants
      • Web Bridge
        • Sélectionner les AOI du site Web | Ancrer, ajuster et vérifier le suivi des AOI
        • Suivi du comportement de la souris sur un AOI de site Web | Guide Web Bridge
      • Questionnaires
      • Application de Bureau
      • Études Échantillons
      • Recrutement des Participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres Sujets

        • Horodatages Précis des Stimuli
        • Études Multi-Utilisateurs
        • Suivi de la Tête dans Labvanced | Guide
    • ONGLETS PRINCIPAUX DE L'APPLICATION

      • Aperçu : Onglets Principaux
      • Tableau de Bord
      • Mes Études
      • Études Partagées
      • Mes Fichiers
      • Bibliothèque d'Expériences
      • Mon Compte
      • Licence & Services
    • ONGLETS D'ÉTUDE

      • Aperçu : Onglets Spécifiques à l'Étude
      • Conception de l'Étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de Tâches
        • Contrôles de Tâches
        • Le Système des Essais
        • Types de cadres
        • Objets
        • Tables de Propriétés des Objets
        • Variables
        • Table des Variables Système
        • Le système d'événements
        • Fonctions de l'Éditeur de Texte
        • Options de suivi oculaire dans l'éditeur de tâche
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateur
      • Paramètres
      • Variables
      • Médias
      • Textes & Traduction
      • Lancer & Participer
      • Gestion des Sujets
      • Vue des Données et Export
        • Vue des données et sélection des variables & des tâches (ancienne version)
        • Accéder aux Enregistrements (Version ANCIENNE)
  • Vidéos
    • Aperçu des vidéos
    • Commencer avec Labvanced
    • Création de tâches
    • Vidéos d'éléments
    • Événements et variables
    • Sujets avancés
  • Tutoriels
    • Introduction
    • Tâche de Stroop
    • Tâche de décision lexicale
    • Tâche de pointage de Posner
    • Paradigme de clignotement de cécité au changement
    • Étude d'exemple de suivi oculaire
    • Étude de suivi oculaire chez les nourrissons
    • Étude de capture attentionnelle avec suivi de la souris
    • Présentation visuelle séquentielle rapide
    • Étude ChatGPT
    • Démonstration de suivi oculaire : SVG en tant qu'AOIs
    • Démonstration multi-utilisateur : montrer les curseurs des sujets
    • Configuration de base du contrôleur Gamepad / Joystick
    • Étude d'application de bureau avec intégration EEG
    • Équilibrage de groupes entre sujets et configuration des variables
    • Construction d'une étude multi-utilisateur
    • Tutoriel de suivi oculaire dans le cadre d'un site web
    • Suivi oculaire par webcam conditionnel
  • FAQ
    • Fonctionnalités
    • Politique et directives de support
    • Sécurité et confidentialité des données
    • Licences
    • Précision de Labvanced
    • Utilisation programmatique et API
    • Utiliser Labvanced hors ligne
    • Dépannage
    • Questions sur la création d'études
  • Archive de la newsletter
  • Documents
  • Salle de classe

Suivi du comportement de la souris sur un AOI de site Web

À l'intérieur d'un cadre de site Web, les événements de souris et le regard sont enregistrés de la même manière sous-jacente : aucun ne peut cibler autre chose qu'un élément Website AOI, c'est le seul objet qu'un cadre de site Web peut contenir. Cette page couvre la construction d'un événement Mouse Trigger sur un AOI de site Web, en entier. Pour le regard, voir le Guide de suivi des yeux du cadre de site Web, l'configuration de déclenchement propre à cet événement est déjà couverte là en détail et n'est pas répétée ici.

Pourquoi cela nécessite une configuration ici, contrairement à ailleurs dans Labvanced

En dehors d'un cadre de site Web, le suivi de la souris fonctionne principalement tout seul : la propriété de suivi continu de la souris d'un cadre enregistre le mouvement du curseur de manière passive, sans déclencheur nécessaire. À l'intérieur de la page intégrée d'un cadre de site Web, ce suivi passif ne s'active jamais, le navigateur du participant ne livre pas le mouvement de la souris à la page parente tant que le curseur se trouve au-dessus d'un iframe, quelle que soit la configuration de Labvanced. Un Mouse Trigger, soutenu par l'extension Labvanced Web Bridge, est le seul moyen d'obtenir des données de souris depuis l'intérieur du cadre. Si vous n'en construisez pas un, un AOI de site Web n'enregistre rien concernant le comportement de la souris, silencieusement, de la même manière qu'un AOI non ancré n'enregistre rien sans que vous le remarquiez.

Les trois modes de ciblage

Ajoutez un événement Mouse Trigger et, à l'intérieur d'un cadre de site Web, sa section Targets: propose trois modes au lieu d'un seul sélecteur de cible :

ModeCe qu'il fait
Any element in website frameS'active pour l'interaction choisie n'importe où sur la page intégrée, que cela se produise ou non sur un AOI enregistré.
Any AOI elementS'active chaque fois que l'interaction se produit sur n'importe quel AOI de site Web enregistré, sans les choisir individuellement.
Choisir des cibles spécifiques (par défaut, aucune case cochée)S'active uniquement pour l'AOI de site Web que vous avez explicitement ajoutée comme cible.

C'est un choix plus riche que ce que le regard reçoit sur le même cadre : les déclencheurs Eyetracking Gaze/Eyetracking Fixation n'offrent que deux modes, Only trigger when looking at specific elements décoché (s'active continuellement, sans ciblage, chaque fois que de nouvelles données de regard existent) ou coché (limité à des cibles AOI spécifiques choisies). Il n'y a pas d'équivalent pour le regard de Any AOI element.

Si les AOI se chevauchent, le mode de ciblage change ce qui compte. Pour Click, PressDown, et PressUp avec des cibles spécifiques choisies, Labvanced vérifie chaque AOI au point de clic, pas seulement celui visuellement au-dessus, donc votre cible s'active toujours, même si un autre AOI est empilé au-dessus à cet endroit. Les modes Any element in website frame et Any AOI element, et Hover/Leave/Move indépendamment du mode, ne considèrent jamais que l'élément supérieur à ce point.

Construire l'événement

  1. Ajoutez un nouvel événement, sélectionnez Mouse Trigger.
  2. Définissez Action: sur l'interaction que vous souhaitez : Click, PressDown, PressUp, Hover, Leave, ou Move. Pour Click, PressDown, et PressUp, un menu déroulant Button: apparaît également, Left ou Right, pour restreindre le déclencheur à un bouton de souris.
  3. Choisissez un mode de ciblage dans le tableau ci-dessus. Si vous laissez les deux cases à cocher décochées, cliquez sur Add Target et sélectionnez les AOI de site Web que vous souhaitez.
  4. Ajoutez une action Set / Record Variable pour réellement capturer les données, un événement sans cela n'enregistre rien, de la même manière qu'un AOI sans un événement Eyetracking Gaze attaché. Définissez le format de la variable sur Array. Pour le type d'enregistrement, Final value garde uniquement la dernière occurrence et Time series garde chaque occurrence. Choisir Time series révèle une option Sampling method supplémentaire : record all (allow repeated duplicates) ou record changes only (no repeated duplicates).
  5. Dans le menu de sélection des valeurs, choisissez parmi la catégorie Trigger (Mouse), c'est ici que se trouvent les valeurs spécifiques à cet événement, décrites dans la section suivante.

Déclencheur : Mouse Trigger → Action : Move → Targets : Any AOI element
Action : Set / Record Variable → Format : Array, Type d'enregistrement : Time series, Méthode d'échantillonnage : record all (allow repeated duplicates) → valeur : Mouse [Name, Info, X, Y] Array de Trigger (Mouse)

Cela enregistre le nom et l'étiquette de l'AOI aux côtés de ses coordonnées X/Y relatives à la page à chaque mouvement de souris au-dessus de tout AOI enregistré, sans nécessiter un événement séparé par AOI.

Choisir une valeur, et l’espace de coordonnées qui l'accompagne

La catégorie Trigger (Mouse) propose :

ValeurCe qu'elle vous donne
MouseX / MouseYLa coordonnée X ou Y à elle seule
Mouse [X,Y] ArrayLes deux coordonnées ensemble
Stimulus NameLe nom de l'objet AOI
Stimulus InfoL'étiquette Stimulus Info de l'AOI
Element TextLe texte visible de l'AOI au moment de l'événement
Mouse [Name, Info, X, Y] ArrayNom, Stimulus Info, et les deux coordonnées ensemble
Mouse [Name, Info, Text, X, Y] ArrayNom, Stimulus Info, texte visible, et les deux coordonnées ensemble

MouseX/MouseY (et les tableaux construits à partir d'eux) ne signifient pas la même chose pour chaque type d'interaction :

  • Click, PressDown, PressUp, Move rapportent des coordonnées relatives à la page, la position sur l'aire scrollable complète de la page intégrée, y compris tout ce que le participant a fait défiler.
  • Hover, Leave rapportent des coordonnées relatives à l'élément à la place, la position au sein de l'AOI elle-même, non pas la page.

Les deux sont étiquetés de manière identique (MouseX, MouseY) dans le sélecteur de valeur, rien dans l'interface ne les distingue en dehors de quel type d'interaction l'événement est construit. Mélanger des données d'un événement Hover et d'un événement Move dans la même colonne exportée mélangera deux espaces de coordonnées différents sans aucun avertissement. Décidez à l'avance quel type d'interaction vous avez réellement besoin avant de câbler l'action d'enregistrement.

Stimulus Name et Stimulus Info identifient quel AOI l'événement s'est déclenché, la même étiquette Stimulus Info couverte dans Nommer un AOI pour vos données exportées, utile une fois que vous enregistrez plus d'un AOI ou en mode Any AOI element. Element Text transporte le texte visible de l'AOI au moment de l'événement.

Partagé avec le regard : les coordonnées relatives à la page incluent le défilement

Les coordonnées relatives à la page décrites ci-dessus (pour Click, PressDown, PressUp, Move) incluent le décalage de défilement interne de l'iframe, pas seulement ce qui est actuellement visible dans la fenêtre d'affichage. Les coordonnées de regard enregistrées sur un AOI de site Web fonctionnent de la même manière. Si vous combinez des données de souris et de regard provenant du même AOI lors de l'analyse, les deux utilisent ce même espace de coordonnées relatives à la page, donc elles s'alignent directement. Vous n'avez pas besoin de convertir l'un pour qu'il corresponde à l'autre.

La position de défilement de la page n'est pas une valeur distincte

La liste des données suivies du guide principal mentionne la position de défilement, mais il n'y a pas de valeur autonome "position de défilement actuelle" à enregistrer à part. Le décalage de défilement n'est jamais appliqué automatiquement que dans les coordonnées relatives à la page déjà décrites ci-dessus (Click, PressDown, PressUp, Move), non exposé comme sa propre variable enregistrable. Si vous avez besoin de comportement de défilement sur une sous-région défilable à l'intérieur d'un AOI spécifiquement, c'est un paramètre distinct, Scrollable container sur l'AOI elle-même, couvert dans Suivi d'une sous-région défilable, et ses données résultantes ne sont disponibles que par le déclencheur Eyetracking Gaze/Eyetracking Fixation, pas Mouse Trigger.

Dépannage

L'événement ne s'active jamais. Confirmez que l'extension Web Bridge est installée et active, rien n'atteint un Mouse Trigger à l'intérieur d'un cadre de site Web sans cela. Si vous utilisez des cibles spécifiques, confirmez que l'AOI que vous avez choisie est réellement ancrée, un AOI non ancré (selectorFound faux) n'activera pas d'événements ciblés même si le déclencheur lui-même est correctement configuré.

Il s'active pour les mauvais éléments, ou trop souvent. Vérifiez quel mode de ciblage est sélectionné. Any element in website frame s'active partout, y compris en dehors de tout AOI, si ce n'est pas ce que vous vouliez dire, passez à Any AOI element ou choisissez des cibles spécifiques à la place.

Les coordonnées enregistrées semblent incorrectes ou incohérentes. Vérifiez quel type d'interaction utilise l'événement. Les coordonnées Hover/Leave sont relatives à l'AOI, Click/PressDown/PressUp/Move sont relatives à la page, voir Choisir une valeur ci-dessus.

Questions Fréquemment Posées

Pourquoi le paramètre de suivi de souris régulier du cadre ne fonctionne-t-il pas à l'intérieur d'un cadre de site Web ?
Parce que le navigateur du participant ne livre jamais le mouvement de la souris à la page parente tant que le curseur se trouve au-dessus d'un iframe, c'est un comportement standard du navigateur, pas une limitation de Labvanced. Seul le flux d'événements propre à l'extension Web Bridge, via un Déclencheur de souris, peut voir l'activité de souris à l'intérieur de la page intégrée.
Dois-je ajouter un AOI de site Web avant de pouvoir suivre le mouvement de la souris ?
Seulement si vous souhaitez cibler des éléments spécifiques ou utiliser le mode Tout élément de l'AOI. Le mode Tout élément dans le cadre du site web s'active indépendamment de la façon dont l'interaction se produit sur un AOI enregistré, il fonctionne donc même sans AOI ajouté.
Pourquoi mes coordonnées de survol sont-elles beaucoup plus petites que mes coordonnées de clic sur le même AOI ?
Elles ne mesurent pas la même chose. Survol/Quitter rapportent des coordonnées relatives à l'élément AOI lui-même, tandis que Cliquez/Appuyer en bas/Appuyer en haut/Déplacer rapportent des coordonnées relatives à la page entière. Les deux utilisent les mêmes noms de valeur MouseX/MouseY, donc cela n'est pas visible depuis le sélecteur de valeur seul.
Quelle est la différence entre Tout élément dans le cadre du site Web et Tout élément AOI ?
Tout élément dans le cadre du site Web s'active pour l'interaction n'importe où sur la page intégrée, AOI ou non. Tout élément AOI s'active uniquement lorsque l'interaction se produit sur un AOI de site Web enregistré, mais ne vous oblige pas à choisir lequel, n'importe lequel d'entre eux fera l'affaire.

Lecture Complémentaire

Labvanced Web Bridge | Support & Guide

La référence complète : installation, cas d'utilisation, données et confidentialité, dépannage et FAQ.

Sélectionner et ajuster les AOI de site Web

Ancrez, ajustez et vérifiez un AOI de site Web avant de construire un événement dessus.

Guide de suivi des yeux du cadre de site Web

La configuration complète de l'événement de suivi du regard, y compris la boîte de dialogue de configuration de l'événement de suivi des yeux.

Prev
Sélectionner les AOI du site Web | Ancrer, ajuster et vérifier le suivi des AOI