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

Sélectionner et Ajuster les AOIs de Site Web

Un AOI de site Web ne suit pas une position d'écran fixe. Il suit un élément spécifique à l'intérieur de la page intégrée, appelé son ancre, identifié par un sélecteur CSS. Obtenir un AOI pour se positionner sur le bon élément concerne principalement le choix et l'ajustement de cette ancre, et non pas son redimensionnement. Cette page couvre l'ensemble des contrôles dans le panneau Website AOI Object Properties : choisir un élément, corriger la sélection avec Parent, Child, Prev, et Next, peaufiner la taille et la position, nommer un AOI pour vos données exportées, filtrer par texte, suivre le défilement à l'intérieur d'un élément, et vérifier qu'un AOI fonctionne réellement avant de publier.

Pour les bases de l'ajout d'un cadre de site Web et de votre premier AOI, consultez Sélectionner les Zones d'Intérêt (AOIs) dans le guide complet de Web Bridge, ou le tutoriel cadre de site Web pour un flux de tâche de bout en bout.

Nota : sélectionner un AOI de site Web montre deux panneaux séparés : un bloc générique Object Properties (Name, Visibility, Active, Position & Size, et un contrôle de grille Anchor) partagé par chaque type d'objet dans Labvanced, et les contrôles spécifiques à l'AOI de site Web que cette page couvre. La grille Anchor du panneau générique est un point de référence position/échelle, sans lien avec l'ancre de sélecteur CSS décrite ci-dessous, et ses champs Position & Size ne déterminent pas ce que suit un AOI de site Web. Utilisez à la place les contrôles de sélecteur CSS ci-dessous.

L'Ancre : Pourquoi un AOI Survit au Défilement

Chaque AOI de site Web stocke un sélecteur CSS, affiché dans le champ CSS Selector de son panneau Object Properties. Ce sélecteur est l'ancre de l'AOI : l'élément unique dans le DOM de la page intégrée auquel l'AOI est lié. Tant que l'élément d'ancrage existe sur la page, l'extension Labvanced Web Bridge continue de rapporter sa position en direct à Labvanced, même pendant que le participant défile, puisque l'élément d'ancrage lui-même se déplace avec la page. C'est pourquoi un AOI correctement ancré continue de suivre correctement à travers le défilement sans que vous ayez à faire quoi que ce soit de supplémentaire : l'ancre, et non une coordonnée d'écran, est ce qui est suivi.

L'implication pratique : si un AOI semble perdre de vue sa cible, l'ancre elle-même est généralement le problème (elle pointe vers le mauvais élément, ou cet élément n'existe plus sur la page), et non sa taille ou sa position.

Un sélecteur ne suit jamais qu'un seul élément. S'il correspond à plus d'un élément sur la page, par exemple un nom de classe partagé à travers un ensemble de cartes répétées, l'AOI suit celui qui arrive en premier dans la structure de la page, et non tous. Cela provient principalement d'un sélecteur tapé à la main basé sur une classe partagée ; un sélecteur produit par Pick Element ou les contrôles de navigation ci-dessous est ancré à l'élément exact sur lequel vous êtes tombé et n'a pas ce problème.

Pourquoi "Sélectionner un Élément" Ne Se Pose Pas Toujours sur l'Élément Exact

Avant que vous n'ayez choisi ou tapé un sélecteur, le panneau ne montre que CSS Selector, Pick Element, Stimulus Info, Text Filter, Scrollable container, et Show AOI overlay in player. Adjust selection (Parent/Child/Prev/Next) et les champs de décalage de taille/position n'apparaissent qu'une fois qu'un sélecteur existe réellement.

Pick Element ne s'ancre pas toujours à l'élément exact que vous cliquez. Il recherche un bon conteneur à sélectionner, favorisant un élément avec son propre ID ou un élément naturellement interactif comme un lien, un bouton, ou un champ de saisie, et s'il ne trouve pas un élément proche, il se rabat sur un conteneur voisin. En pratique, cela signifie que cliquer sur un titre ou un morceau de texte à l'intérieur d'une carte sélectionne souvent la carte entière, et non juste ce titre. Quand cela arrive, utilisez les contrôles de navigation ci-dessous pour descendre jusqu'à l'élément exact que vous aviez en tête.

Appuyez sur Esc à tout moment lors de la sélection pour annuler sans changer le sélecteur actuel de l'AOI. Vous pouvez également sauter entièrement le sélecteur et taper ou coller un sélecteur CSS directement dans le champ CSS Selector, utile si vous connaissez déjà le sélecteur souhaité ou si le sélecteur continue de le manquer.

Corriger la Sélection : Parent, Enfant, Précédent, Suivant

Une fois qu'un sélecteur CSS est défini, quatre boutons apparaissent sous Adjust selection: dans le panneau Object Properties :

BoutonSe déplace vers
↑ ParentL'élément conteneur de l'élément actuel
↓ ChildLe premier élément enfant de l'élément actuel
← PrevLe frère précédent au même niveau
→ NextLe frère suivant au même niveau

Ce sont les principaux moyens de corriger une sélection, plus que son redimensionnement. Le flux de travail typique lorsque Pick Element se pose sur le mauvais élément : cliquez sur Child pour descendre dans le premier élément interne du conteneur, puis Next (ou Prev) pour vous déplacer latéralement entre les frères de cet élément jusqu'à atteindre celui que vous voulez réellement. Si cela reste encore trop haut, cliquez à nouveau sur Child pour descendre un niveau supplémentaire, puis déplacez-vous encore latéralement. Chaque clic régénère le sélecteur pour l'endroit où vous atterrissez, donc l'AOI s'ancre toujours à cet élément exact, et non à un chemin composé à travers ses ancêtres.

Si un bouton n'a rien vers quoi se déplacer (Prev sans frère précédent, Child sur un élément sans enfants, ou Parent lorsque le seul élément au-dessus est le html/body externe de la page), rien ne se passe : la sélection reste là où elle était, sans message d'erreur. Si un bouton de navigation semble non réactif, vous avez probablement atteint le bord de la structure de la page dans cette direction, essayez un autre bouton à la place.

Peaufiner la Taille et la Position

Une fois un élément ancré, deux contrôles supplémentaires apparaissent pour de petites corrections au pixel près, distincts de la navigation ci-dessus :

  • Size offset (px, ± per side) : agrandit ou réduit la zone suivie d'un nombre de pixels défini sur les axes X et Y, appliqué symétriquement de chaque côté.
  • Position shift (px) : déplace la zone suivie d'un nombre de pixels défini sans changer sa taille.

Utilisez ces contrôles uniquement après que l'ancre elle-même est correcte. Ils ajustent la limite d'un élément déjà correctement ancré ; ils ne changent pas quel élément est suivi.

Un AOI de site Web est toujours un rectangle, la boîte englobante de n'importe quel élément auquel il est ancré. Il n'y a pas d'option polygonale ou de forme personnalisée ici, contrairement aux AOIs sur des stimuli construits directement dans Labvanced. Si l'élément que vous devez suivre n'est pas lui-même rectangulaire, ancrez-le à l'élément rectangulaire le plus petit qui le contient, puis utilisez Size offset pour réduire la boîte.

Nommer un AOI pour Vos Données Exportées

Le champ Stimulus Info est une courte étiquette textuelle pour l'AOI. Il est rempli automatiquement à partir du texte de l'élément que vous sélectionnez ou naviguez (ou le nom de la balise de l'élément s'il n'a pas de texte), et vous pouvez l'éditer pour quelque chose de plus clair. Cette étiquette apparaît comme la valeur Stimulus Info dans les déclencheurs d'événements et les données exportées, c'est donc ainsi que vous indiquez à quel AOI appartient réellement un regard, un clic ou un survol donné une fois qu'une image a plus d'un AOI dessus.

Donnez à chaque AOI une étiquette Stimulus Info distincte avant de commencer à collecter des données réelles. Une étiquette remplie automatiquement copiée du texte d'un élément, comme "Ajouter au panier", est correcte en soi, mais devient confuse une fois que le même texte apparaît sur plus d'un AOI.

Filtre de Texte

Le champ Text Filter limite l'AOI à n'être actif que lorsque le texte visible de son élément ancré contient une chaîne spécifique (la correspondance est insensible à la casse). C'est utile lorsque votre sélecteur d'ancrage pourrait plausiblement correspondre à un élément dont le texte change, par exemple un label de statut qui passe par plusieurs états, et que vous ne souhaitez que que l'AOI soit comptée comme active pour un état spécifique.

Suivre un Sous-Région Défilable

Si l'élément auquel vous vous êtes ancré a son propre défilement interne, par exemple un panneau de chat ou une liste de produits défilable imbriquée dans la page, cochez Scrollable container. Cela indique à Labvanced de suivre également la position de défilement et les dimensions de contenu de cet élément, séparément du défilement global de la page.

Ces données ne sont révélées que par le déclencheur Eyetracking Gaze/Eyetracking Fixation, pas Mouse Trigger. Lorsque le regard se place à l'intérieur d'un AOI de conteneur défilant, son menu de valeurs sélectionnables offre Container Relative X/Container Relative Y (position dans le contenu défilable complet du conteneur, et non seulement ce qui est actuellement visible) en plus de Container Scroll X/Container Scroll Y (la distance à laquelle le conteneur lui-même a défilé). Consultez Suivi du Comportement de la Souris sur un AOI de Site Web pour ce que le Déclencheur Souris enregistre au lieu sur le même AOI.

Vérifier qu'un AOI Fonctionne Réellement

Un AOI qui échoue à s'ancrer, parce que son sélecteur ne correspond à rien sur la page actuelle, que l'élément cible n'a pas encore chargé, ou que l'extension Web Bridge n'est pas active, ne montre pas d'erreur par défaut au participant ou au chercheur. Il reste simplement inactif : aucune donnée de regard, de clic, ou de survol n'est enregistrée contre lui, et rien dans l'étude n'indique visiblement cela.

Pendant que vous construisez une étude, chaque AOI se rend déjà comme une superposition colorée directement dans l'éditeur, le vert signifie que son sélecteur correspond actuellement à un élément sur la page, le rouge signifie qu'il ne correspond pas, sans aucun basculement nécessaire pour voir cela pendant que vous travaillez. Show AOI overlay in player étend cette même superposition à Preview et à la study en direct elle-même, ce qui confirme réellement un AOI de bout en bout et pas seulement pendant l'édition. Prévisualisez toujours votre étude avec cela activé au moins une fois, confirmez que chaque AOI est vert, puis désactivez-le à nouveau avant de publier si vous ne souhaitez pas que les participants voient la superposition.

Éléments qui Apparaissent ou Disparaissent (Dialogues, Modaux)

L'ancre d'un AOI de site Web n'a pas besoin d'être présente sur la page tout le temps. Parce que l'extension vérifie continuellement si le sélecteur CSS correspond actuellement à quoi que ce soit, un AOI ancré à un élément à l'intérieur d'une boîte de dialogue, modal, ou autre contenu qui n'apparaît qu'à certains moments, s'active lorsque cet élément apparaît et se désactive lorsqu'il est supprimé, sans configuration supplémentaire. Cela vous permet de suivre les interactions avec des éléments qui n'existent que temporairement, par exemple une boîte de dialogue de confirmation qui s'ouvre après une action spécifique, en utilisant le même mécanisme d'ancrage décrit ci-dessus.

Questions Fréquemment Posées

Devrais-je utiliser le décalage de taille pour rendre un AOI plus petit, ou est-ce le mauvais outil ?
Généralement le mauvais outil. Si un AOI couvre trop ou pas assez de la page, la solution est presque toujours de choisir une ancre différente avec Parent, Child, Prev, ou Next, et non de réduire ou d'agrandir l'existant. Réservez Size offset et Position shift pour de petites corrections une fois que l'ancre elle-même est déjà correcte.
Pourquoi "Sélectionner un Élément" a-t-il sélectionné un conteneur plus grand que celui sur lequel j'ai cliqué ?
Le sélecteur recherche un bon conteneur sélectionnable près de l'endroit où vous avez cliqué plutôt que le pixel exact, donc il peut tomber sur une carte, un lien, ou un bouton environnant plutôt que sur un morceau de texte ou d'image spécifique à l'intérieur. Utilisez Child puis Next/Prev pour descendre jusqu'à l'élément exact.
J'ai cliqué sur Suivant ou Enfant et rien ne s'est passé. Est-ce un bug ?
Non. S'il n'y a pas de frère dans cette direction, ou pas d'élément enfant dans lequel se déplacer, le bouton ne fait rien et la sélection reste telle qu'elle était, sans message d'erreur affiché. Essayez une direction différente.
Comment savoir si un AOI suit réellement quelque chose ?
Activez Afficher la superposition AOI dans le lecteur dans son panneau Propriétés de l'Objet et prévisualisez l'étude. Le vert signifie que le sélecteur correspond actuellement à un élément sur la page ; le rouge signifie qu'il ne correspond pas. Il n'y a pas d'erreur visible pour le participant si un AOI échoue à s'ancrer, donc vérifiez cela avant de publier.
Un AOI de site Web peut-il suivre un élément à l'intérieur d'un popup ou d'une boîte de dialogue qui n'est pas toujours sur la page ?
Oui. L'AOI s'active chaque fois que son élément d'ancrage existe sur la page et se désactive lorsqu'il n'existe pas, donc une ancre à l'intérieur d'une boîte de dialogue ou modal qui ne s'ouvre qu'à certains moments fonctionne de la même manière qu'un autre AOI, sans configuration supplémentaire.

Lectures Complémentaires

Labvanced Web Bridge | Support & Guide

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

Tutoriel de Suivi des Yeux avec le Cadre de Site Web

Un flux de tâche de bout en bout, de l'installation de l'extension à la lecture de vos données de regard exportées.

Suivi du Comportement de la Souris sur un AOI de Site Web

Construire un événement de Déclencheur de Souris une fois votre AOI ancré, et la différence d'espace de coordonnées entre les types d'interaction.

Next
Suivi du Comportement de la Souris sur une AOI de Site Web | Guide Web Bridge