Written by Beata Lewandowska
CSV file: AOI click count
The "AOI click count" 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 - the 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 give to an AOI while saving it,
- string aoi_item_parts - exact AOI parameters (area and time range), especially important for multi-AOI,
- float aoi_size_percents - 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_click_total_count - how many clicks each participant made within this AOI,
- int aoi_click_average_time_to_first_click_ms - TTFC (time to first click) within given AOI,
- int aoi_fixation_ttff_ms - TTFF (time to first fixation) within the given AOI.
- 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: