Learn how to use RealEye.io - distributed webcam eye-tracking platform.

Beata Lewandowska
Written by Beata Lewandowska

CSV file: AOI fixation stats


With RealEye you can not only download the Raw Data CSV, but also download the AOI data. You can obtain the CSV file from the main study dashboard or from the item heatmap dashboard - in this case you'll get data only for this particular item.

The CSV contains the following fields:

  • string study_id - UUID,
  • string item_id - UUID,
  • string item_filename - the name of your file, as it was named while adding to study,
  • string item_cdn_url - URL to the tested item saved on our servers,
  • string tester_id - UUID,
  • string tester_external_id - (UUID) in case if you provide one by connecting the study with an external tool, i.e. a survey,
  • string tester_display_name - a name that a participant gives while asked about a name, gender, and age at the end of the study (if you have chosen that option), i.e. "Anna, Female, 27",
  • int tester_quality_grade - participant's grade from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • int tester_quality_grade_item - item's grade from 1 to 6 where:
  • 1 = very low,
  • 2 = low,
  • 3 = average,
  • 4 = good,
  • 5 = very good,
  • 6 = perfect;
  • int test_item_display_order - a number indicating the order in which the items were displayed.
  • string aoi_id - UUID,
  • string aoi_name - the name that you gave the AOI while saving it,
  • string aoi_item_parts - exact AOI parameters (area and time range), especially important for multi AOI,
  • float aoi_size_percents - AOI size expressed as the percentage value relative to the size of the entire image,
  • int aoi_time_range_from_ms - the start time from which the values of the AOI were calculated (you can set this time with the orange slider under the heatmap),
  • int aoi_time_range_to_ms - the end time to which the values of the AOI were calculated (you can set this time with the orange slider under the heatmap),
  • int aoi_fixation_total_count - number of fixations within this area,
  • int aoi_fixation_average_duration_ms - the time that the average fixation lasted for (in milliseconds),
  • int aoi_fixation_ttff_ms - the amount of time that it takes participants (on average) to look at this area (in milliseconds),
  • int aoi_fixation_average_total_time_spent_ms - the amount of time that participants spent looking at this area (in milliseconds),
  • int aoi_fixation_first_fixation_average_duration_ms - the time that the average first fixation lasted for (in milliseconds),
  • notes - this column contains:
  • RealEye version,
  • fixation filter settings:
  • gazepoint interpolation (Hz) - to improve calculations we interpolate the data to 60 Hz;
  • gazepoint interpolation max gap (ms) - we interpolate data if the timestamp gap between two input values is not bigger than this value (50 ms);
  • gaze velocity threshold;
  • min. fixation duration (Ms);
  • noise reduction level,
  • TestCriteria - data was downloaded for participants:
  • isGenderMale={true/false},
  • isGenderFemale={true/false},
  • isGenderOther={true/false},
  • isGenderUnknown={true/false},
  • qualityMin={from1 to 6},
  • qualityMax={from 1 to 6},
  • isTesterTypeRealEye={true/false},
  • isTesterTypeNonRealEye={true/false},
  • timestamp of when the file was downloaded.


See the CSV file for the sample study:



API: https://www.realeye.io/docs/api/#aoi-data-export

Categories: