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 the study,
- string item_cdn_url - URL to the tested item saved on our servers,
- string participant_id - UUID,
- string participant_external_id - UUID (in case you provide one by connecting the study with an external tool, i.e., a survey),
- string participant_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",
- string participant_tags - tags assigned to a participant (added by the study owner),
- int participant_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 participant_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,
- int exposure_number - (only applicable for Website Mockup studies) indicates the time the participant saw an item, i.e., 1 means that the participant saw this item for the first time,
- 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),
- int aoi_visit_total_count - number of visits; each time a participant looked at the AOI and left at least one fixation is counted as a visit,
- int aoi_revisit_total_count - number of revisits (number of visits minus 1),
- string external_data_debug - all the external variables assigned to the participant (if applicable),
- 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);
- max. fixation duration (Ms);
- moving median range (Ms);
- saccade max duration (Ms);
- TestCriteria - data was downloaded for participants:
- age=min:max,
- isGenderMale={true/false},
- isGenderFemale={true/false},
- isGenderOther={true/false},
- isGenderNotSpecified={true/false},
- qualityMin={from1 to 6},
- qualityMax={from 1 to 6},
- tags={tag1},{tag2},...,
- keys=KEY{anykey},
- isParticipantTypeRealEye={true/false},
- isParticipantTypeNonRealEye={true/false},
- timestamp of when the file was downloaded.
See the CSV file for the sample study: