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
    • COMMEÇANT

      • Éditeur de Tâches
      • Cadres
        • Cadre de Canevas
        • Cadre de Page
        • Cadre de Site Web
      • Chronologie de l'Essai
      • Présentation des Stimuli
      • Exactitude de la Réponse
      • Objets
      • Événements
      • Variables
      • Assistant de Tâches
      • Système d'Essai
      • Conception de l'Expérience
        • Créer une étude
        • Modèles de Data Frame
        • Conception d'Expériences Multi-utilisateurs
    • SUJETS MISE EN AVANT

      • 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
        • Utilisation des formes comme zones d'intérêt (AOI) pour le suivi oculaire
        • L'expérience de calibration du participant
      • Pont Web
        • Sélectionner les AOIs de site Web | Ancrer, ajuster et vérifier le suivi des AOIs
        • Suivi du Comportement de la Souris sur une AOI de Site Web | Guide Web Bridge
      • Questionnaires
      • Application de Bureau
      • Études Échantillons
      • Recrutement de Participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres Sujets

        • Chronologie Précise 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
        • Tables 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âches
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateur
      • Paramètres
      • Variables
      • Médias
      • Textes & Traduire
      • Lancer & Participer
      • Gestion des Sujets
      • Vue des Données et Exportation
        • 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 & Variables
    • Sujets avancés
  • Guides
    • Introduction
    • Tâche de Stroop
    • Tâche de décision lexicale
    • Tâche de suivi du regard 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 souris
    • Présentation visuelle rapide en série
    • Étude ChatGPT
    • Démo de suivi oculaire : SVG comme AOI
    • Démo multi-utilisateur : Afficher les curseurs des sujets
    • Manette / Contrôleur Joystick - Configuration de base
    • Étude d'application de bureau avec intégration EEG
    • Équilibrage de groupe entre sujets et configuration des variables
    • Construire une étude multi-utilisateur
    • Guide de suivi oculaire dans un cadre de site Web
    • Suivi oculaire en mode conditionnel
  • FAQ
    • Fonctionnalités
    • Politique et directives de support
    • Sécurité & Protection des données
    • Licences
    • Précision de Labvanced
    • Utilisation programmatique & API
    • Utiliser Labvanced hors ligne
    • Dépannage
    • Questions sur la création d'études
  • Archives de la newsletter
  • Documents
  • Salle de classe

Suivi du Comportement de la Souris sur une 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 d'eux ne peut cibler quoi que ce soit sauf un élément Website AOI, c'est le seul objet qu'un Cadre de Site Web peut contenir. Cette page couvre la création d'un événement Mouse Trigger sur une AOI de Site Web, en entier. Pour le regard, consultez le Guide de Suivi Oculaire de Cadre de Site Web, la configuration d'événement de ce déclencheur est déjà couverte là-bas 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 passivement, sans déclencheur requis. À 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 est sur une iframe, quelle que soit la configuration Labvanced. Un Mouse Trigger, soutenu par l'extension Web Bridge de Labvanced, est le seul moyen d'obtenir des données de souris à l'intérieur du cadre. Si vous n'en construisez pas un, une AOI de Site Web n'enregistre rien concernant le comportement de la souris, silencieusement, de la même manière qu'une AOI non ancrée n'enregistre rien sans que vous ne 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 que ça fait
Any element in website frameS'active pour l'interaction choisie n'importe où sur la page intégrée, qu'elle se produise ou non au-dessus d'une AOI enregistrée.
Any AOI elementS'active chaque fois que l'interaction se produit au-dessus de n'importe quelle AOI de Site Web enregistrée, sans les sélectionner individuellement.
Cibler des cibles spécifiques (par défaut, aucune case cochée)S'active uniquement pour les AOI de Site Web que vous avez explicitement ajoutées comme cible.

C'est un choix plus riche que ce que le regard obtient sur le même cadre : les déclencheurs Eyetracking Gaze/Eyetracking Fixation n'offrent que deux modes, Only trigger when looking at specific elements non coché (s'active en continu, non ciblé, 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 de regard à 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 celle visuellement au sommet, de sorte que votre cible s'active toujours même si une autre AOI est empilée au-dessus. Les modes Any element in website frame et Any AOI element, et Hover/Leave/Move peu importe le mode, ne considèrent jamais que l'élément le plus haut à ce moment.

Création de l'Événement

  1. Ajoutez un nouvel événement, sélectionnez Mouse Trigger.
  2. Définissez Action: sur l'interaction que vous voulez : 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 non 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'une AOI sans un événement Eyetracking Gaze attaché. Réglez le Format de la variable sur Array. Pour le Type d'Enregistrement, Final value ne garde que la dernière occurrence et Time series garde chacune d'entre elles. 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 de valeur, 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 à côté de ses coordonnées X/Y relatives à la page à chaque mouvement de souris au-dessus de n'importe quelle AOI enregistrée, sans avoir besoin d'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 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 à travers chaque type d'interaction :

  • Click, PressDown, PressUp, Move rapportent des coordonnées relatives à la page, la position dans la zone de défilement complète de la page intégrée, y compris tout ce que le participant a défilé.
  • Hover, Leave rapportent des coordonnées relatives à l'élément à la place, la position à l'intérieur de l'AOI elle-même, 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 au-delà du type d'interaction sur lequel l'événement est construit. Mélanger les 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 avertissement. Décidez au préalable quel type d'interaction vous avez réellement besoin avant de câbler l'action d'enregistrement.

Stimulus Name et Stimulus Info identifient quelle AOI l'événement s'est activé, la même étiquette Stimulus Info couverte dans Nommer une AOI pour Vos Données Exportées, utile une fois que vous enregistrez plus d'une AOI ou à partir du mode Any AOI element. Element Text contient 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 interne de défilement de l'iframe, pas seulement ce qui est actuellement visible dans le viewport. Les coordonnées de regard enregistrées sur une AOI de Site Web fonctionnent de la même manière. Si vous combinez les données de souris et celles du regard à partir de la même AOI lors de l'analyse, les deux utilisent ce même espace de coordonnées relatif à la page, donc elles s'alignent directement. Vous n'avez pas besoin de convertir l'une pour correspondre à l'autre.

La Position de Défilement de la Page N'est Pas une Valeur Séparée

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 seule. Le décalage de défilement n'est appliqué automatiquement qu'à l'intérieur des coordonnées relatives à la page déjà décrites ci-dessus (Click, PressDown, PressUp, Move), pas exposé en tant que variable enregistrable à part entière. Si vous avez besoin de comportement de défilement sur une sous-région défilable à l'intérieur d'une 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 les données résultantes ne sont disponibles que via 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, une AOI non ancrée (selectorFound faux) ne déclenchera pas d'événements ciblés même si le déclencheur lui-même est configuré correctement.

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 toute AOI, si ce n'est pas ce que vous vouliez, 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 l'événement utilise. Les coordonnées Hover/Leave sont relatives à l'AOI, Click/PressDown/PressUp/Move sont relatives à la page, consultez Choisir une Valeur ci-dessus.

Questions Fréquemment Posées

Pourquoi le paramètre de suivi de souris normal 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 est sur une iframe, c'est un comportement standard du navigateur, pas une limitation de Labvanced. Seul le flux d'événements de l'extension Web Bridge, via un Déclencheur de Souris, peut voir l'activité de la souris à l'intérieur de la page intégrée.
Dois-je ajouter une 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 N'importe quel élément AOI. Le mode N'importe quel élément dans le cadre du site web s'active indépendamment de la question de savoir si l'interaction se produit au-dessus d'une AOI enregistrée, donc il fonctionne même sans ajout d'AOI.
Pourquoi mes coordonnées de Survol sont-elles si beaucoup plus petites que mes coordonnées de Clic sur la 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 Clic/AppuyerVersLeBas/AppuyerVersLeHaut/Déplacer rapportent des coordonnées relatives à la page entière. Les deux utilisent les mêmes noms de valeur SourisX/SourisY, donc cela n'est pas visible depuis le sélecteur de valeur seul.
Quelle est la différence entre N'importe quel élément dans le cadre du site web et N'importe quel élément AOI ?
N'importe quel é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. N'importe quel élément AOI ne s'active que lorsque l'interaction se produit au-dessus d'une AOI de Site Web enregistrée, mais ne nécessite pas que vous sélectionniez laquelle, n'importe laquelle d'elles fera l'affaire.

Lectures Supplémentaires

Labvanced Web Bridge | Support & Guide

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

Sélection et Ajustement des AOI de Site Web

Ancrez, ajustez et vérifiez une AOI de Site Web avant de créer un événement dessus.

Guide du Suivi Oculaire de Cadre de Site Web

La configuration complète des événements de suivi oculaire, y compris la boîte de dialogue de configuration de l'Événement de Regard.

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