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
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Leitfaden
    • STARTEN

      • Aufgaben-Editor
      • Rahmen
        • Canvas Frame
        • Seitenrahmen
        • Website-Frame
      • Versuchszeitachse
      • Stimuluspräsentation
      • Richtigkeit der Antwort
      • Objekte
      • Ereignisse
      • Variablen
      • Aufgaben-Assistent
      • Versuchssystem
      • Experimentdesign
        • Eine Studie erstellen
        • Datenrahmen-Muster
        • Multi-User-Experimentdesign
        • Längsschnitt-Experimentdesign
    • HERVORHEBENSWERTES THEMA

      • Randomisierung & Balance
      • Eye Tracking
        • Präsentation von Stimuli in einer Augenverfolgungsaufgabe
        • So Wählen Sie die Einstellungen zur Kalibrierung der Augenverfolgung
        • Einrichtung der Augenverfolgung in einer Aufgabe
        • Aufzeichnen und Exportieren von Blickdaten
        • Verwendung von Formen als Interessensgebiete (AOI) für das Eye Tracking
        • Die Teilnehmerkalibrierungserfahrung
      • Web-Bridge
        • Auswählen von Website-AOIs | Ankern, Anpassen und Überprüfen der AOI-Verfolgung
        • Verfolgen des Mausverhaltens auf einer Website AOI | Web Bridge Anleitung
      • Fragebögen
      • Desktop-App
      • Beispielstudien
      • Teilnehmerrekrutierung
      • API-Zugriff
        • REST API
        • Webhook-API
        • WebSocket API
      • Sonstige Themen

        • Genauigkeit der Stimuluszeiten
        • Multinutzerstudien
        • Kopfverfolgung in Labvanced | Anleitung
    • Haupt-App-TABS

      • Übersicht: Haupt-Tabs
      • Dashboard
      • Meine Studien
      • Geteilte Studien
      • Meine Dateien
      • Experimentbibliothek
      • Mein Konto
      • Lizenz & Dienstleistungen
    • STUDIENTABS

      • Übersicht: Studien-spezifische Tabs
      • Studien-Design
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
      • Aufgaben-Editor
        • Aufgabensteuerungen
        • Das Versuchs-System
        • Frame-Typen
        • Objekte
        • Objekt Eigenschaften Tabellen
        • Variablen
        • Systemvariablen Tabelle
        • Das Ereignissystem
        • Texteditor-Funktionen
        • Optionen für Eye Tracking im Aufgabeneditor
        • Kopfverfolgung in einer Aufgabe
        • Mehrbenutzer-Studien
      • Einstellungen
      • Variablen
      • Medien
      • Texte & Übersetzen
      • Starten & Teilnehmen
      • Teilnehmermanagement
      • Datensicht und Export
        • Datensicht und Variablen- & Aufgaben Auswahl (alte Version)
        • Zugriff auf Aufnahmen (ALTE Version)
  • Videos
    • Video Übersicht
    • Erste Schritte in Labvanced
    • Aufgaben erstellen
    • Element Videos
    • Ereignisse & Variablen
    • Fortgeschrittene Themen
  • Durchführungen
    • Einführung
    • Stroop-Aufgabe
    • Lexikalische Entscheidungsaufgabe
    • Posner-Blickführung Aufgabe
    • Change Blindness Flicker Paradigma
    • Augenbewegungsverfolgung Beispielstudie
    • Studie zur Augenbewegungsverfolgung bei Säuglingen
    • Aufmerksamkeitsfängerstudie mit Mausverfolgung
    • Schnelle serielle visuelle Präsentation
    • ChatGPT Studie
    • Augenverfolgungsdemo: SVGs als AOIs
    • Multi-User Demo: Cursorn der Probanden anzeigen
    • Gamepad / Joystick Controller - Grundkonfiguration
    • Desktop-App-Studie mit EEG-Integration
    • Gruppenbalance und Variablenkonfiguration zwischen Probanden
    • Aufbau einer Multi-User-Studie
    • Augenverfolgung während eines Website-Rahmen-Walkthroughs
    • Bedingte Webcam-Augenverfolgung
    • Aufbau einer Studie zur Textsegmentierung
  • FAQ
    • Funktionen
    • Support-Richtlinien & Leitlinien
    • Sicherheit & Datenschutz
    • Lizenzierung
    • Präzision von Labvanced
    • Programmgesteuerter Gebrauch & API
    • Labvanced offline nutzen
    • Fehlerbehebung
    • Fragen zur Studienerstellung
  • Newsletter-Archiv
  • Dokumente
  • Klassenzimmer
Ein Mouse Trigger-Ereignis, das auf einer Website AOI innerhalb eines Labvanced Website Frames ausgelöst wird

Verfolgen des Mausverhaltens auf einer Website AOI

Innerhalb eines Website Frames werden sowohl Mausereignisse als auch Blickverhalten auf die gleiche zugrunde liegende Weise erfasst: Keine der beiden kann auf etwas anderes als ein Website AOI-Element abzielen, das ist das einzige Objekt, das ein Website Frame enthalten kann. Diese Seite behandelt die vollständige Erstellung eines Mouse Trigger-Ereignisses auf einer Website AOI. Für das Blickverhalten siehe das Website Frame Eye Tracking Walkthrough, die Einrichtung eines solchen Ereignisses ist dort bereits detailliert beschrieben und wird hier nicht wiederholt.

Warum dies hier eingerichtet werden muss, im Gegensatz zu anderen Bereichen in Labvanced

Außerhalb eines Website Frames funktioniert das Mausverfolgen im Grunde genommen: Die kontinuierliche Mausverfolgungseigenschaft eines Frames erfasst die Cursorbewegung passiv, ohne dass ein Trigger erforderlich ist. Innerhalb der eingebetteten Seite eines Website Frames wird dieses passive Tracking jedoch nie ausgelöst, da der Browser des Teilnehmers während der Cursor über ein iframe ist, keine Mausbewegungen an die übergeordnete Seite überträgt, unabhängig von den Labvanced-Einstellungen. Ein Mouse Trigger, gestützt durch die Labvanced Web Bridge-Erweiterung, ist der einzige Weg, um überhaupt irgendwelche Mausdaten von innerhalb des Frames zu erhalten. Wenn Sie keinen erstellen, zeichnet eine Website AOI nichts über das Mausverhalten auf, stillschweigend, genau wie eine unbefestigte AOI ohne Ihr Wissen nichts aufzeichnet.

Die drei Zielmodi

Fügen Sie ein Mouse Trigger-Ereignis hinzu, und innerhalb eines Website Frames bietet der Targets:-Abschnitt drei Modi anstelle eines einzelnen Zielwählers:

ModusWas er tut
Any element in website frameWird für die gewählte Interaktion überall auf der eingebetteten Seite ausgelöst, unabhängig davon, ob sie über einer registrierten AOI erfolgt.
Any AOI elementWird immer ausgelöst, wenn die Interaktion über einer registrierten Website AOI stattfindet, ohne sie einzeln auszuwählen.
Bestimmte Ziele auswählen (Standard, kein Kästchen angekreuzt)Wird nur für die Website AOI(s) ausgelöst, die Sie ausdrücklich als Ziel hinzugefügt haben.

Dies ist eine reichere Auswahl, als das Blickverhalten auf demselben Frame erhält: Die Eyetracking Gaze/Eyetracking Fixation-Trigger bieten nur zwei Modi, Only trigger when looking at specific elements nicht angekreuzt (wird kontinuierlich, ohne Ziel ausgelöst, wann immer neue Blickdaten vorhanden sind) oder angekreuzt (begrenzt auf bestimmte ausgewählte AOI-Ziele). Es gibt kein Pendant zum Blickverhalten für Any AOI element.

Wenn AOIs sich überschneiden, ändert sich der Zielmodus, was zählt. Für Click, PressDown, und PressUp mit bestimmten ausgewählten Zielen überprüft Labvanced jede AOI am Klickpunkt, nicht nur die, die visuell darüber liegt, sodass Ihr Ziel weiterhin ausgelöst wird, selbst wenn eine andere AOI dort darüber gestapelt ist. Any element in website frame und Any AOI element-Modi sowie Hover/Leave/Move unabhängig vom Modus berücksichtigen nur das einzelne oberste Element an diesem Punkt.

Ereignis erstellen

  1. Fügen Sie ein neues Ereignis hinzu, wählen Sie Mouse Trigger.
  2. Setzen Sie Action: auf die gewünschte Interaktion: Click, PressDown, PressUp, Hover, Leave, oder Move. Für Click, PressDown, und PressUp erscheint ein Button:-Dropdown, Left oder Right, um den Trigger auf eine Maustaste zu beschränken.
  3. Wählen Sie einen Zielmodus aus der obigen Tabelle aus. Wenn Sie beide Kontrollkästchen nicht ankreuzen, klicken Sie auf Add Target und wählen Sie die Website AOI(s), die Sie möchten.
  4. Fügen Sie eine Set / Record Variable-Aktion hinzu, um tatsächlich Daten zu erfassen, ein Ereignis ohne eine solche zeichnet nichts auf, genau wie eine AOI ohne ein Eyetracking Gaze-Ereignis. Setzen Sie das Format der Variablen auf Array. Für den Datensatztyp hält Final value nur die letzte Vorkommen und Time series hält jede einzelne. Die Auswahl von Time series gibt eine weitere Sampling method-Option frei: record all (allow repeated duplicates) oder record changes only (no repeated duplicates).
  5. Wählen Sie im Wertauswahlmenü aus der Trigger (Mouse)-Kategorie aus, hier befinden sich die Werte, die spezifisch für dieses Ereignis sind, die im nächsten Abschnitt beschrieben werden.

Trigger: Mouse Trigger → Action: Move → Targets: Any AOI element
Aktion: Set / Record Variable → Format: Array, Datensatztyp: Time series, Probenahmemethode: record all (allow repeated duplicates) → Wert: Mouse [Name, Info, X, Y] Array von Trigger (Mouse)

Dies zeichnet den Namen und das Label der AOI zusammen mit seinen seitenrelativen X/Y auf, bei jeder Mausbewegung über einer registrierten AOI, ohne ein separates Ereignis pro AOI zu benötigen.

Auswahl eines Wertes und des damit verbundenen Koordinatenraums

Die Trigger (Mouse)-Kategorie bietet:

WertWas er Ihnen gibt
MouseX / MouseYDie X- oder Y-Koordinate für sich
Mouse [X,Y] ArrayBeide Koordinaten zusammen
Stimulus NameDen Objektnamen der AOI
Stimulus InfoDas Stimulus Info-Label der AOI
Element TextDen sichtbaren Text der AOI zum Zeitpunkt des Ereignisses
Mouse [Name, Info, X, Y] ArrayName, Stimulus Info, und beide Koordinaten zusammen
Mouse [Name, Info, Text, X, Y] ArrayName, Stimulus Info, sichtbaren Text und beide Koordinaten zusammen

MouseX/MouseY (und die von ihnen erstellten Arrays) bedeuten nicht dasselbe über jeden Interaktionstyp hinweg:

  • Click, PressDown, PressUp, Move berichten über seitenrelative Koordinaten, die Position im gesamten scrollbar Bereich der eingebetteten Seite, einschließlich dessen, was der Teilnehmer bereits nach unten gescrollt hat.
  • Hover, Leave berichten stattdessen über elementrelative Koordinaten, die Position innerhalb der AOI selbst, nicht auf der Seite.

Beide werden im Wertauswahlfeld identisch beschriftet (MouseX, MouseY), nichts in der Benutzeroberfläche unterscheidet sie über den Interaktionstyp, auf dem das Ereignis aufgebaut ist. Das Mischen von Daten aus einem Hover-Ereignis und einem Move-Ereignis in derselben exportierten Spalte mischt zwei verschiedene Koordinatenräume ohne jegliche Warnung. Entscheiden Sie im Voraus, welchen Interaktionstyp Sie tatsächlich benötigen, bevor Sie die Aufzeichnungsaktion anschließen.

Stimulus Name und Stimulus Info identifizieren, auf welcher AOI das Ereignis ausgelöst wurde, dasselbe Stimulus Info-Label, das in Benennen einer AOI für Ihre exportierten Daten behandelt wird, nützlich, wenn Sie von mehr als einer AOI oder im Any AOI element-Modus aufzeichnen. Element Text trägt den sichtbaren Text der AOI zum Zeitpunkt des Ereignisses.

Gemeinsam mit Blickverhalten: Seitenrelative Koordinaten beinhalten Scrollen

Die oben beschriebenen seitenrelativen Koordinaten (für Click, PressDown, PressUp, Move) beinhalten den internen Scrollversatz des iframes, nicht nur das, was derzeit im Ansichtsfenster sichtbar ist. Blickkoordinaten, die auf einer Website AOI aufgezeichnet wurden, funktionieren auf die gleiche Weise. Wenn Sie Maus- und Blickdaten von derselben AOI während der Analyse kombinieren, verwenden beide diesen gleichen seitenrelativen Koordinatenraum, sodass sie direkt übereinstimmen. Sie müssen nicht einen anpassen, um dem anderen zu entsprechen.

Die Seitenposition ist kein separater Wert

Die Liste der erfassten Daten des Hauptleitfadens erwähnt die Scrollposition, aber es gibt keinen eigenständigen "aktuelle Scrollposition"-Wert, den man selbst aufzeichnen kann. Der Scrollversatz wird nur automatisch auf die bereits beschriebenen seitenrelativen Koordinaten angewendet (Click, PressDown, PressUp, Move), nicht als eigenes aufzeichnungsfähiges Variable offengelegt. Wenn Sie spezifisch das Scrollverhalten in einem scrollbareren Unterbereich innerhalb einer AOI benötigen, ist das eine separate Einstellung, Scrollable container auf der AOI selbst, die in Tracking eines scrollbareren Unterbereichs behandelt wird, und die resultierenden Daten sind nur über den Eyetracking Gaze/Eyetracking Fixation-Trigger verfügbar, nicht Mouse Trigger.

Fehlerbehebung

Das Ereignis wird nie ausgelöst. Bestätigen Sie, dass die Web Bridge-Erweiterung installiert und aktiv ist, nichts erreicht ein Mouse Trigger innerhalb eines Website Frames ohne sie. Wenn Sie spezifische Ziele verwenden, bestätigen Sie, dass die von Ihnen ausgewählte AOI tatsächlich verankert ist, eine unbefestigte AOI (selectorFound falsch) wird nicht gezielte Ereignisse auslösen, auch wenn der Trigger selbst korrekt konfiguriert ist.

Es wird für die falschen Elemente oder zu oft ausgelöst. Überprüfen Sie, welcher Zielmodus ausgewählt ist. Any element in website frame wird überall ausgelöst, auch außerhalb jeder AOI, wenn das nicht gemeint war, wechseln Sie zu Any AOI element oder wählen Sie stattdessen spezifische Ziele aus.

Die aufgezeichneten Koordinaten sehen falsch oder inkonsistent aus. Überprüfen Sie, welchen Interaktionstyp das Ereignis verwendet. Hover/Leave-Koordinaten sind relativ zur AOI, Click/PressDown/PressUp/Move sind relativ zur Seite, siehe Auswahl eines Wertes oben.

Häufig gestellte Fragen

Warum funktioniert die reguläre Mausverfolgungseinstellung des Frames nicht innerhalb eines Website Frames?
Weil der Browser des Teilnehmers niemals Mausbewegungen an die übergeordnete Seite überträgt, während der Cursor über ein iframe ist, dies ist das Standardverhalten des Browsers, keine Einschränkung von Labvanced. Nur der eigene Ereignisstrom der Web Bridge-Erweiterung, über einen Mouse Trigger, kann Mausaktivität innerhalb der eingebetteten Seite sehen.
Muss ich eine Website AOI hinzufügen, bevor ich Mausbewegungen verfolgen kann?
Nur wenn Sie spezifische Elemente anvisieren oder den Modus Any AOI element verwenden möchten. Der Modus Any element in website frame wird unabhängig davon ausgelöst, ob die Interaktion über einer registrierten AOI stattfindet, sodass er sogar ohne hinzugefügte AOI funktioniert.
Warum sind meine Hover-Koordinaten so viel kleiner als meine Click-Koordinaten auf derselben AOI?
Sie messen nicht dasselbe. Hover/Leave melden Koordinaten relativ zum AOI-Element selbst, während Click/PressDown/PressUp/Move Koordinaten relativ zur gesamten Seite melden. Beide verwenden dieselben MouseX/MouseY-Wertnamen, sodass dies aus der Wertauswahl alleine nicht sichtbar ist.
Was ist der Unterschied zwischen Any element in website frame und Any AOI element?
Any element in website frame wird für die Interaktion überall auf der eingebetteten Seite ausgelöst, unabhängig davon, ob es sich um eine AOI handelt oder nicht. Any AOI element wird nur ausgelöst, wenn die Interaktion über einer registrierten Website AOI stattfindet, es ist jedoch nicht erforderlich, dass Sie auswählen, welche, jede von ihnen funktioniert.

Weiterführende Literatur

Labvanced Web Bridge | Support & Guide

Labvanced Web Bridge | Support & Guide

Das vollständige Referenzhandbuch: Installation, Anwendungsfälle, Daten und Datenschutz, Fehlerbehebung und FAQ.

Auswählen und Anpassen von Website AOIs

Auswählen und Anpassen von Website AOIs

Eine Website AOI verankern, anpassen und überprüfen, bevor Sie ein Ereignis darauf aufbauen.

Website Frame Eye Tracking Walkthrough

Website Frame Eye Tracking Walkthrough

Die vollständige Einrichtung des Blickverhalten-Events, einschließlich des Dialogfelds zur Augenerfassung.

Prev
Auswählen von Website-AOIs | Ankern, Anpassen und Überprüfen der AOI-Verfolgung