---
title: "CSV file: AOI overall stats"
description: "CSV file: AOI overall stats"
---

[Skip to content](http://support.realeye.io/aoi-overall-stats-csv#main-content)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png)](https://support.realeye.io/?hsLang=en)

Open main navigation

Close main navigation

- [Contact us](mailto:contact@realeye.io)

[Contact us](mailto:contact@realeye.io)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [RealEye Knowledge Base](http://support.realeye.io/?hsLang=en)
2. [Analyzing Study Results](http://support.realeye.io/analyzing-study-results?hsLang=en)

# CSV file: AOI overall stats

---

 

The "AOI overall stats" CSV contains the same metrics that are included in [AOI](https://support.realeye.io/what-is-aoi/?hsLang=en) on the heatmap dashboard. There are 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,
- int **participant\_count** - for how many participants the eye-tracking data was collected for this item,
- string **aoi\_id** - UUID,
- string **aoi\_name** - the name that you give to an AOI while saving it,
- JSON ARRAY **aoi\_item\_parts** - exact AOI parameters (contains many parts in case of multi AOI), depending on AOI's type has the following structure:
  
  *Rectangle:*
  
  ```
  {     "areaPoints": {        "topLeft": {            "xPx": int,            "yPx": int,        },        "bottomRight": {            "xPx": int,            "yPx": int,        },    },    "timeRange": {        "fromMs": int,        "toMs": int,    },    "size": {        "overallPercents": float,        "widthPercents": float,        "heightPercents": float,    },}
  ```
  
  *Polygon:*
  
  ```
  {     "areaPoints": {        "points": [            { "x": float, "y": float, },            { "x": float, "y": float, },            ...        ],    },    "timeRange": {        "fromMs": int,        "toMs": int,    },    "size": {        "overallPercents": float,    },}
  ```
  
  > NOTE:
  > 
  > Main diffrence between structures is area points interpretation. For rectangle AOI points (top-left and bottom-right) are defined in pixels of an item. Polygon area is described by normalized points (from 0 to 1 ) ordered by drawing sequence.
- float **aoi\_size\_overall\_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\_fixation\_total\_count** - number of fixations within this area,
- int **aoi\_fixation\_average\_ttff\_ms** - the amount of time that it takes participants (on average) to make the first fixation at this area (in milliseconds),
- int **aoi\_fixation\_average\_total\_time\_spent\_ms** - the average amount of time that all the participant's fixations lasted in total (in milliseconds),
- int **aoi\_fixation\_average\_fixation\_duration\_ms** - the time that the average fixation lasted for (in milliseconds),
- int **aoi\_fixation\_average\_first\_fixation\_duration\_ms** - the time that the average first fixation lasted for (in milliseconds),
- int **aoi\_fixation\_participant\_ratio\_percents** - how many of all the participants looked at the given area (based on fixations),
- int **aoi\_gaze\_total\_count** - number of gazes within this area,
- int **aoi\_gaze\_average\_time\_to\_first\_gaze\_at\_ms** - the amount of time that it takes participants (on average) to look at this area (in milliseconds),
- int **aoi\_gaze\_average\_total\_time\_spent\_ms** - the average amount of time that a participant looked at the area based on gazes (in milliseconds),
- int **aoi\_gaze\_total\_time\_spent\_ms** - the total amount of time that all participants looked at the area based on gazes (in milliseconds),
- float **aoi\_gaze\_participant\_ratio\_percents** - how many of all the participants looked at the given area (based on gazes),
- int **aoi\_visit\_total\_count** - AOI visit is detected if there's a fixation within the AOI (or many fixations "one after another"),
- int **aoi\_revisit\_total\_count** - how many times participants looked back at the AOI (in total),
- float **aoi\_revisit\_average\_count** - how many times participants looked back at the AOI (on average),
  
  > NOTE:
  > 
  > If the participant didn't looked at the AOI, then visits = 0, revisits = 0.  
  > If the participant looked once at the AOI, then visits = 1, revisits = 0.  
  > If the participant looked N-times at the AOI, then visits = N, revisits = N-1.  
  > The " average revisits count takes into the account those who have not looked at the AOI (it includes those with 0 visits and revisits).  
  > We count separate visit if there's a long data gap between fixations.
- int **aoi\_click\_total\_count** - how many clicks all participants made within this AOI,
- int **aoi\_click\_average\_time\_to\_first\_click\_ms** - the amount of time that it takes participants (on average) to click at this area for the first time,
- float **aoi\_k\_coefficient** - the average k-coefficient within this AOI,
- **notes** - this column contains:
- RealEye version,
- [fixation filter](https://realeye.user.com/knowledge-base/articles/60/update/63/%7B%%20kb_article_url%2053%20%%7D) 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](https://www.realeye.io/item/ff85ad25-1933-403f-a1f6-af42a44094c1/):

- [AOI overall stats](https://docs.google.com/spreadsheets/d/14PRNXivRd8XMi9PhULmwgKKWgxDSPpfDSb-T2qGKatY/edit?usp=sharing)

API: [https://www.realeye.io/docs/api/#aoi-data-export](https://www.realeye.io/docs/api/#aoi-data-export)

- [Getting started](http://support.realeye.io/getting-started?hsLang=en)
- [(Webcam) Eye-Tracking Basics](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#main-content)

    - [RealEye accuracy](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#realeye-accuracy)
- [Licenses & Pricing](http://support.realeye.io/licenses-pricing?hsLang=en)
- [Account Settings](http://support.realeye.io/account-settings?hsLang=en)
- [Study Setup & Settings](http://support.realeye.io/study-setup-settings?hsLang=en#main-content)

    - [Study Types](http://support.realeye.io/study-setup-settings?hsLang=en#study-types)
- [Content Setup & Stimuli (Items) Settings](http://support.realeye.io/content-setup-stimuli-items-settings?hsLang=en)
- [Managing Participants](http://support.realeye.io/managing-participants?hsLang=en)
- [Analyzing Study Results](http://support.realeye.io/analyzing-study-results?hsLang=en)
- [Advanced Features & Integrations](http://support.realeye.io/advanced-features-integrations?hsLang=en)
- [Security & Privacy](http://support.realeye.io/security-privacy?hsLang=en)
- [Troubleshooting](http://support.realeye.io/troubleshooting?hsLang=en)
- [Ghost articles](http://support.realeye.io/ghost-articles?hsLang=en)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png "logotype")](http://realeye.io)

RealEye sp. z o. o.  
Obornicka 330  
60-689 Poznań  
Tax: PL9721299175

<https://www.facebook.com/> [mailto:support@realeye.io](mailto:support@realeye.io)

Copyright © 2024, RealEye sp. z o. o.