labvanced logoLabVanced
Contact
    • Remote Physiological Measurements
    • Eye Tracking
    • Head & Face-Tracking
    • Emotion Detection
    • Heart Rate Detection (rPPG)
    • Generative AI
    • Audio Transcription
    • EEG & Hardware Integrations
    • Decision Making
    • Reaction Times
    • Keyboard Inputs
    • Mouse Tracking
    • Mobile / Touch
    • Questionnaires
    • Gamepad / Joystick Integration
    • Audio Recordings
    • Audio Transcription
    • Video Recordings
    • Screen Recordings
    • Photos / Snapshots
    • Video Conferencing
    • Canvas Drawings
    • Build with AI
    • Build with Spreadsheets
    • Using the Experiment Editor
    • Coding
    • Creating Questionnaires
    • Balancing & Randomization
    • UX & Website Testing
    • Single Session Studies
    • Factorial Designs
    • Longitudinal & Multi-session Studies
    • Individual & Case Studies
    • Real-time Multi-user Studies
    • Interviews & Video Calls
    • Surveys & Questionnaires
    • Experience Sampling & Diaries
    • Classroom & Group Testing
    • Interventions & Clinical Trials
    • In the Browser
    • Mobile App
    • Desktop App
    • WebBridge Chrome Extension
    • Stroop Test
    • Flanker Task
    • N-back Task
    • Implicit Association Test
    • Trail Making Test
    • Digit Span
    • Corsi Block Tapping
    • Tower of London
    • Balloon Analog Risk Task
    • Preferential Looking
    • Browse more →
    • DASS-21
    • GAD-7
    • Rosenberg Self-Esteem Scale
    • PHQ-9
    • Ten-Item Personality Inventory
    • Big Five Personality Test
    • Adult ADHD Self-Report Scale
    • Browse more →
    • Building a Multi-user Study
    • Webcam Eye Tracking with AOIs
    • Website Frame Eye Tracking
    • Conditional Eye Tracking Opt-in
    • ChatGPT Study
    • Desktop App Study with EEG
    • Between-subjects Group Balancing
    • Building a Reading Study
    • Stroop Task
    • Lexical Decision Task
    • Browse more →
    Public Experiment Library
    • Arts Research
    • Clinical Psychology & Neuropsychology Medicine
    • Cognitive Psychology
    • Developmental Psychology
    • Behavioral Economics & Decision Science
    • Educational Research & Psychology
    • HCI & Human Factors
    • Linguistics & Language Sciences
    • Consumer & Marketing Research
    • Social & Personality Psychology
    • Sport & Movement Science
    • UX & Website Testing
    • Executive Functions
    • Language & Reading
    • Decision-Making & Reasoning
    • Attention
    • Overview
    • HCI & Human Factors
    • UX & Website Testing
    • Consumer & Marketing Research
    • White-Label App
    • PageGazer
    • Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela Markova
    • Eye Tracking for Influencer MarketingDr. Alexander Edeling
    • Eye Tracking Infant Word ComprehensionDr. Giulia Calignano
    • Sentence Reading and Grammar JudgmentsDr. Jonathan Mirault
    • Regulating Emotions with MusicDr. Katrin Starcke
    • Game-Based Grammar Learning in ChildrenDr. Mireia Marimon
    • Gaze Cueing and AutismMax Soares Miehstein
    • Personality and Hearing in NoiseDr. Malte Wöstmann
    • All interviews →
    • Lab Notes
    • How to Cite Labvanced
    • Labvanced Platform Paper (2017)
    • Webcam Eye Tracking Validation (2024)
    • Webcam Eye Tracking Studies
    • Cognitive Psychology Studies
    • Developmental Psychology Studies
    • Linguistics Studies
    • See all publications →
    • Getting Started
    • Guide
    • Video Tutorials
    • Walkthroughs
    • Live Chat
    • Webinars & Onboarding Calls
    • AI Assistant
    • FAQ
    • Importing Templates Guide
    • Test Templates
    • Live Eye Tracking Metrics
    • Mouse Tracking Demo
    • ChatGPT Demo
    • Audio Recording Object Demo
    • Adding Image Stimuli Demo
    • Score & Feedback Demo
    • Browse all technical demos →
    • Timing Precision
    • Stimuli Presentation
    • Headphone Checks
    • Bot Checks
    • Participant Management
    • Comparisons
    • Research Blog
    • Prolific Integration
    • CloudResearch Integration
    • Sona Systems Integration
    • BeSample Integration
    • Panelabs Integration
    • Clickworker Integration
    • Labvanced Webhook API
    • Labvanced REST API
    • About Us
    • Newsletter Archive
    • Terms & Conditions
    • Data Security & Data Privacy
    • Technical & Organisational Measures
    • Accessibility
    • W-8BEN-E Form
    • Data Processing Agreement Template
    LinkedInYouTubeDiscord
    • Individual
    • Lab
    • Department / Consortium
    • Teaching
    • Campus
    • Commercial
    • Browse recording top-ups →
    • Browse AI token top-ups →
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • EN
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Logout
    • Loginlogin icon
    Platform
    Labvanced makes it easy to implement the most advanced study design and reliably collect your data.
    Biosignals & AI
    Remote Physiological MeasurementsEye TrackingHead & Face-TrackingEmotion DetectionHeart Rate Detection (rPPG)Generative AIAudio TranscriptionEEG & Hardware Integrations
    Behavioral Recordings
    Decision MakingReaction TimesKeyboard InputsMouse TrackingMobile / TouchQuestionnairesGamepad / Joystick Integration
    Media Recordings
    Audio RecordingsAudio TranscriptionVideo RecordingsScreen RecordingsPhotos / SnapshotsVideo ConferencingCanvas Drawings
    Implementation Techniques
    Build with AIBuild with SpreadsheetsUsing the Experiment EditorCodingCreating QuestionnairesBalancing & RandomizationUX & Website Testing
    Study Formats

    Your study can take whatever format your research needs. Here are a few popular examples.

    Single Session StudiesFactorial DesignsLongitudinal & Multi-session StudiesIndividual & Case StudiesReal-time Multi-user StudiesInterviews & Video CallsSurveys & QuestionnairesExperience Sampling & DiariesClassroom & Group TestingInterventions & Clinical Trials
    Where Studies Run

    Run your study online in the browser, on mobile or tablet with the mobile app, or in-lab with the desktop app.

    In the BrowserMobile AppDesktop AppWebBridge Chrome Extension
    Tests
    Explore cognitive tests, questionnaires, walkthroughs, and our public experiment library: a starting point for your next study.
    Popular Cognitive Tests
    Stroop TestFlanker TaskN-back TaskImplicit Association TestTrail Making TestDigit SpanCorsi Block TappingTower of LondonBalloon Analog Risk TaskPreferential Looking
    Browse more →
    Questionnaires & Scales
    DASS-21GAD-7Rosenberg Self-Esteem ScalePHQ-9Ten-Item Personality InventoryBig Five Personality TestAdult ADHD Self-Report Scale
    Browse more →
    Public Experiment Library

    Take a look at what other researchers in the community are doing through our extensive, open catalog of shared studies.

    Open the public library →
    Walkthroughs

    Step-by-step builds of complete studies, from a blank project to a running experiment, that you can follow along or adapt.

    Building a Multi-user StudyWebcam Eye Tracking with AOIsWebsite Frame Eye TrackingConditional Eye Tracking Opt-inChatGPT StudyDesktop App Study with EEGBetween-subjects Group BalancingBuilding a Reading StudyStroop TaskLexical Decision Task
    Browse more →
    Research
    One platform for students, academics, and industry researchers studying human behavior.
    Harvard UniversityStanford UniversityCambridge UniversityUCLNYUMax Planck InstituteUCLATU Munich

    Trusted by researchers at 1,500+ universities worldwide

    Academic Research
    Arts ResearchClinical Psychology & Neuropsychology MedicineCognitive PsychologyDevelopmental PsychologyBehavioral Economics & Decision ScienceEducational Research & PsychologyHCI & Human FactorsLinguistics & Language SciencesConsumer & Marketing ResearchSocial & Personality PsychologySport & Movement ScienceUX & Website Testing
    Research Areas
    Executive FunctionsLanguage & ReadingDecision-Making & ReasoningAttention
    Industry / Commercial
    OverviewHCI & Human FactorsUX & Website TestingConsumer & Marketing ResearchWhite-Label AppPageGazer
    Researcher Interviews

    Conversations with researchers about the studies they ran with Labvanced, what worked, and what they learned.

    Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela MarkovaEye Tracking for Influencer MarketingDr. Alexander EdelingEye Tracking Infant Word ComprehensionDr. Giulia CalignanoSentence Reading and Grammar JudgmentsDr. Jonathan MiraultRegulating Emotions with MusicDr. Katrin StarckeGame-Based Grammar Learning in ChildrenDr. Mireia MarimonGaze Cueing and AutismMax Soares MiehsteinPersonality and Hearing in NoiseDr. Malte Wöstmann
    All interviews →
    Our Research
    Lab NotesHow to Cite Labvanced
    Peer Reviewed Studies

    A selection of peer-reviewed work built on Labvanced: our own platform and validation papers, and studies by the research community grouped by area. Hundreds more are listed on the full publications page.

    Labvanced Platform Paper (2017)Webcam Eye Tracking Validation (2024)Webcam Eye Tracking StudiesCognitive Psychology StudiesDevelopmental Psychology StudiesLinguistics Studies
    See all publications →
    Resources
    Valuable resources to help you learn the platform, stay updated, and more.
    Documentation
    Getting StartedGuideVideo TutorialsWalkthroughs
    Support
    Live ChatWebinars & Onboarding CallsAI AssistantFAQ
    Templates & Demos

    These are a few popular examples. Browse our guide and a selection of technical demos to get started with implementation.

    Importing Templates GuideTest TemplatesLive Eye Tracking MetricsMouse Tracking DemoChatGPT DemoAudio Recording Object DemoAdding Image Stimuli DemoScore & Feedback Demo
    Browse all technical demos →
    Methodology
    Timing PrecisionStimuli PresentationHeadphone ChecksBot ChecksParticipant ManagementComparisonsResearch Blog
    Integrations & APIs
    Prolific IntegrationCloudResearch IntegrationSona Systems IntegrationBeSample IntegrationPanelabs IntegrationClickworker IntegrationLabvanced Webhook APILabvanced REST API
    Company & Legal
    About UsNewsletter ArchiveTerms & ConditionsData Security & Data PrivacyTechnical & Organisational MeasuresAccessibilityW-8BEN-E FormData Processing Agreement Template
    LinkedInYouTubeDiscord
    Pricing
    Our licenses and additional services at a glance.
    Licenses
    IndividualLabDepartment / ConsortiumTeachingCampusCommercial
    Top-Ups

    Need more recordings for your lab or your own research? Simply use one of these recording top-up packages.

    Browse recording top-ups →

    Need more AI tokens for the AI assistant and study translations? Simply use one of these AI token top-up packages.

    Browse AI token top-ups →
    Additional Services

    Hire Labvanced’s expert team to quickly bring your project to the level of rigor it needs.

    OverviewStudy BuildingSubject RecruitmentDedicated Support
    Checkout

    Ready to purchase a license or top-up? Head straight to checkout.

    Go to checkout →
    • 中國人
    • Deutsch
    • Français
    • Español
    • English
    • 日本語
    • Getting Started
    • Guide
      • GETTING STARTED

        • Task Editor
        • Frames
          • Canvas Frame
          • Page Frame
          • Website Frame
          • Overlays & Dialogs | Labvanced
        • Trial Timeline
        • Stimulus Presentation
        • Correctness of Response
        • Objects
        • Events
        • Variables
        • Task Wizard
        • AI Assistant
        • Trial System
        • Experiment Design
          • Creating a Study
          • Importing Templates in Labvanced
          • Data Frame Patterns
          • Multi-user Experiment Design
          • Longitudinal Experiment Design
      • FEATURED TOPICS

        • Randomization & Balance
        • Eye Tracking
          • Presenting Stimuli in an Eye Tracking Task
          • How to Choose Eye Tracking Calibration Settings
          • Setting Up Eye Tracking in a Task
          • Recording and Exporting Gaze Data
          • Using Shapes as Areas of Interest (AOI) for Eye Tracking
          • The Participant Calibration Experience
        • Web Bridge
          • Selecting Website AOIs | Anchor, Adjust, and Verify AOI Tracking
          • Tracking Mouse Behavior on a Website AOI | Web Bridge Guide
        • Questionnaires
        • Desktop App
        • Sample Studies
        • Participant Recruitment
        • API Access
          • REST API
          • Webhook API
          • WebSocket API
        • Other Topics

          • Precise Stimulus Timings
          • Multi User Studies
          • Head Tracking in Labvanced | Guide
      • MAIN APP TABS

        • Overview: Main Tabs
        • Dashboard
        • My Studies
        • Shared Studies
        • My Files
        • Experiment Library
        • My Account
        • License & Services
      • STUDY TABS

        • Overview: Study-Specific Tabs
        • Study Design
          • Tasks
          • Blocks
          • Sessions
          • Groups
        • Task Editor
          • Task Controls
          • The Trial System
          • Frame Types
          • Objects
          • Object Property Tables
          • Variables
          • System Variables Table
          • The Event System
          • Text Editor Functions
          • Eye Tracking Options in the Task Editor
          • Head Tracking in a Task
          • Multi-User Studies
        • Settings
        • Variables
        • Media
        • Texts & Translate
        • Launch & Participate
        • Subject Management
        • Dataview and Export
    • Video Tutorials
      • Video Overview
      • Getting Started in Labvanced
      • Creating Tasks
      • Element Videos
      • Events & Variables
      • Advanced Topics
    • Walkthroughs
      • Introduction
      • Stroop Task
      • Lexical Decision Task
      • Posner Gaze Cueing Task
      • Change Blindness Flicker Paradigm
      • Eye-tracking Sample Study
      • Infant Eye-tracking Study
      • Attentional Capture Study with Mouse Tracking
      • Rapid Serial Visual Presentation
      • ChatGPT Study
      • Eye Tracking Demo: SVGs as AOIs
      • Multi-User Demo: Show Subjects' Cursors
      • Gamepad / Joystick Controller- Basic Set Up
      • Desktop App Study with EEG Integration
      • Between-subjects Group Balancing and Variable Setup
      • Building a Multi-user Study
      • Website Frame Eye Tracking Walkthrough
      • Conditional Webcam Eye Tracking
      • Text Segmentation Study Building
      • Building a Study with AI
    • FAQ
      • Features
      • Support Policy & Guidelines
      • Security & Data Privacy
      • Licensing
      • Precision of Labvanced
      • Programmatic Use & API
      • Using Labvanced Offline
      • Troubleshooting
      • Study Creation Questions
    Eyetracking Gaze Trigger firing on new gaze predictions in Labvanced

    Eyetracking Gaze Trigger

    Table of Contents

    • Overview
      • Common Use Cases
    • Enabling Eye Tracking
    • Recording Gaze Data
    • Trigger-specific Values
    • Studies & Example Scenarios
    • Further Reading

    Overview

    The Eyetracking Gaze trigger fires every time Labvanced's webcam eye tracking predicts a new gaze location for a participant, whether or not eye tracking is restricted to a specific frame or object.

    Note: All processing occurs client-side, ensuring GDPR compliance and guaranteeing that no facial data is ever transmitted or stored externally.

    Triggers on:

    • Overall: this trigger applies whenever eye tracking has been enabled for the task.
    • Only when looking at specific elements: restrict the trigger to fire only when the participant's gaze lands on stimulus objects you have added as targets.

    Common Use Cases

    The Eyetracking Gaze trigger suits studies that need a continuous record of where a participant looks, or a reaction to every gaze update.

    • Recording a gaze timeseries: save gaze coordinates, capture time, and confidence for every prediction. See Recording and Exporting Gaze Data.
    • Restricting gaze to stimuli: fire only when the gaze lands on specific objects, with Polygon and SVG masks defining the regions. See Using Shapes as Areas of Interest (AOI).
    • Reading and text studies: capture gaze on individual words with the Text Segmentation Object.
    • Detecting settled gaze: when you want one event per fixation rather than one per gaze sample, use the Eyetracking Fixation Trigger instead.

    Enabling / Activating Eye Tracking

    For the Eyetracking Gaze trigger to actually record data, eye tracking has to be switched on twice: once for the study as a whole, and again for the specific task you're building. There are three places this can happen: adding this trigger to an event, the Settings tab, or a task's Physiological Signals tab. Whichever one you do first, Labvanced opens the Set up eye tracking wizard: a short series of questions asking for a calibration tier and, for tiers that support it, a screening level. See Choosing a Tier for what each choice means. Both are editable later from the study's Settings tab, and since the wizard is a pop-up dialog, you need to get through it before you can do anything else.

    Selecting the Trigger in the Event Wizard

    The most direct way to turn eye tracking on is to just add this trigger: clicking the Eyetracking Gaze trigger tile turns eye tracking on for that task and, if needed, for the study, immediately, no separate checkbox required.

    1. Click the Eyetracking Gaze trigger tile. If this is the study's first time using eye tracking, the setup wizard mentioned above opens right here, before you can continue.
    2. If applicable, select targets to limit the trigger to specific stimulus objects.
    3. Name the event.
    4. The automated Eyetracking Gaze Event Setup dialog appears.

    Study Settings - Enable Eye Tracking

    Eye tracking can also be turned on ahead of time, independent of any specific event. In the Settings tab, go to Physiology → Eye-Tracking and check the box. This switches eye tracking on for the study, but not for any individual task, you still need to turn it on separately for each task where you want to record gaze data, either by adding this trigger (above) or via Task Controls below.

    Task Settings - Enable Eye Tracking

    In the task editor, open Task Controls, go to the Physiological Signals tab, and check Enable Eye-Tracking:. This works the same way as adding the trigger above: it turns eye tracking on for that task, and if the study doesn't have it on yet, this one checkbox turns it on at the study level too, no separate trip to Settings needed. Recalibration, drift correction, and Fixation Detection are also configured in this tab, and the available options differ between Eye Tracking 2.0 and 1.3 and earlier, see Setting Up Eye Tracking in a Task for the version-specific reference.

    Checking Enable Eye-Tracking: also opens a dialog offering to automatically create the gaze and fixation recording events for you, across all frames or just one:

    Eyetracking Setup dialog offering to automatically create gaze and fixation recording events

    The Eyetracking Setup dialog, offering to automatically create the gaze and fixation recording events across all frames, or a single selected frame.

    Recording Gaze Data

    The Eyetracking Gaze Event Setup dialog, the one that appears when you add the trigger directly, lets you pick which values to auto-record:

    Accepting Record gaze timeseries [X,Y,T,C] (checked by default) creates a Set / Record Variable action using the Coord. + Time + Confidence [X,Y,T,C] Array trigger-specific value described below, with Record Type set to All changes / time series so every gaze update is captured rather than just the final value per trial. A second option, Record per-eye gaze + confidence [Lx,Ly,Lc,Rx,Ry,Rc,T] Array (unchecked by default), instead records the left and right eye's coordinates and confidence separately, using the trigger-specific value of the same name described below.

    Preview of Gaze Data Collected in Labvanced

    Preview of data collected using Labvanced's webcam eye tracking.

    Preview of data collected using Labvanced's webcam eye tracking
    X: X-coordinate of gaze; Y: Y-coordinate of gaze; T: Timestamp; C: Confidence Interval

    Trigger-specific Values for Gaze

    Upon selecting the Eyetracking Gaze trigger, the following options are available in the Value-Select Menu:

    The gaze trigger value options in the value select menu, including the Image Quality and Gaze Correction arrays added in Eye Tracking 2.0

    Accessing the trigger-specific values of the Eyetracking Gaze trigger via the Value-select Menu.

    Trigger (Eyetracking Gaze) OptionsDescription
    Coordinate XThe value of the gaze's X coordinate.
    Coordinate YThe value of the gaze's Y coordinate.
    Coordinate [X,Y] ArrayThe gaze coordinates X,Y in an array format.
    Stimulus NameThe name of the stimulus that initiated the gaze trigger.
    Stimulus InfoThe stimulus information behind the stimulus that initiated the gaze trigger.
    Camera Capture Time TThe adjusted timestamp of when the camera actually captured the image. In Labvanced's eye tracking pipeline, a camera snapshot happens before the algorithm performs gaze calculations, so Camera Capture Time T is the more accurate timestamp to use than a trigger or recording timestamp.
    Gaze Confidence CRanges from 0 to 1; the confidence and probability that there is an open eye in the image snapshot, serving as a blink detector. See Kaduk et al., 2024 for more detail.
    Coord. + Time [X,Y,T] ArrayAn array containing the gaze coordinates and the camera capture time.
    Coord. + Time + Confidence [X,Y,T,C] ArrayAn array containing the gaze coordinates, camera capture time, and gaze confidence. This is the recommended value for most studies, and what the automated event setup above creates by default.
    Per-Eye Gaze + Confidence + Time [Lx,Ly,Lc,Rx,Ry,Rc,T] ArrayAn array containing the left and right eye's coordinates and confidence separately (Lx,Ly,Lc,Rx,Ry,Rc), plus the shared camera capture time. Only populated on eye tracking models that report both eyes independently; records as an empty array on older eye tracking versions, single-output models, or during momentary face loss.
    Image Quality [ShL,ShR,BrL,BrR,Spec,Asym,T,FrBr,FrT] ArrayPer-sample image diagnostics from Eye Tracking 2.0: left/right eye sharpness (ShL,ShR) and brightness (BrL,BrR), the worse of the two eyes' specular reflections (Spec), the signed left/right brightness asymmetry (Asym), the sample's own capture time (T), and whole-frame ambient brightness and its timestamp (FrBr,FrT), sampled at about 3 Hz and carried forward between samples. An internal data-quality instrument, useful for diagnosing poor tracking (uneven lighting, a reflection, a blurry camera) rather than for behavioral analysis.
    Gaze Correction [dX,dY] ArrayThe offset, in percent of the screen diagonal, that Eye Tracking 2.0's live correction subtracted from this sample: the head-pose term plus the gaze-check term combined. The raw, uncorrected gaze position is this value added back to the recorded gaze coordinates. Empty when both corrections are off or on a pre-2.0 study.
    Trigger Timestamp (Unixtime)The timestamp of when the gaze trigger occurred, in Unix time with milliseconds.
    Trigger Time (From Frame Onset)The elapsed time in milliseconds from the frame onset to when the gaze trigger occurred.

    Studies & Example Scenarios

    Walkthrough - Study Building

    For worked examples that use this trigger, see the Eyetracking Walkthrough or Webcam Eye Tracking Demo: SVGs as AOIs, which restricts the trigger to specific stimulus objects using Polygon and SVG masks.


    Self-Paced Reading Study (Text Segmentation Object - Demo)

    See the Text Segmentation Object in a real study: ten sentences, one per trial, with per-word AOI geometry and eye tracking metrics recorded automatically.

    Preferential Looking Test

    This study measures visual preference and attentional bias using gaze tracking. Participants view social and non-social stimuli while fixation behavior, head movement, and video recordings are captured for analysis.

    Simon Task with Eye Tracking

    This study measures cognitive control and stimulus-response compatibility using the Simon Task. Participants respond to stimulus color while ignoring spatial position, allowing measurement of the Simon effect through reaction time and accuracy.



    Further Reading

    Recording and Exporting Gaze Data

    Recording and Exporting Gaze Data

    Building this trigger into a full recording setup, and reading the resulting data export.

    Eyetracking Fixation Trigger

    Eyetracking Fixation Trigger

    The sibling trigger for when a participant's gaze settles on a location, rather than every gaze sample.

    Using Shapes as Areas of Interest (AOI)

    Using Shapes as Areas of Interest (AOI)

    Restricting this trigger to specific stimulus objects using Polygon and SVG masks.