Tobii: Most-used fields#
The table below gives information about most-used fields that you can import from Tobii. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
ad_technical_format |
ad_technical_format |
The technical format or type of the advertisement, e.g., display, video, interstitial. |
dimension |
date |
date |
The date when the attention data was collected or the impression occurred. |
dimension |
demographics.age |
demographics.age |
The age of the participant viewing the content. |
metric |
demographics.area |
demographics.area |
The geographical area or region of the participant. |
dimension |
demographics.country_code |
demographics.country_code |
The country code of the participant’s location. |
dimension |
demographics.date_of_birth |
demographics.date_of_birth |
The date of birth of the participant. |
dimension |
demographics.gender |
demographics.gender |
The gender of the participant. |
dimension |
eyetracker_enabled |
eyetracker_enabled |
A boolean indicating whether eye-tracking functionality was enabled during the session. |
dimension |
first_event_at |
first_event_at |
Timestamp indicating when the first event related to the impression or element occurred. |
dimension |
first_fixation_at |
first_fixation_at |
Timestamp indicating when the participant’s gaze first fixated on the element or impression. This is similar to ‘Time until noticed’ for an AOI. |
dimension |
first_pixel_inview_at |
first_pixel_inview_at |
Timestamp indicating when the element or impression first had at least one pixel visible on the screen. |
dimension |
fixation_count |
fixation_count |
The total number of times a participant’s gaze fixated on the element or impression. |
metric |
height |
height |
The height of the tracked content element or advertisement, measured in pixels. |
metric |
hostname |
hostname |
The hostname of the website or digital content being viewed by the panelist. |
dimension |
impression_id |
impression_id |
A unique identifier for a specific ad impression, representing a single instance of an ad being displayed to a user. |
dimension |
is_fixated |
is_fixated |
A boolean indicating whether the element or impression was fixated by the participant’s gaze. This relates to the ‘Seen by’ metric for an AOI. |
dimension |
is_iab_inview |
is_iab_inview |
Indicates whether the ad impression was considered ‘in-view’ according to Interactive Advertising Bureau (IAB) viewability standards. |
dimension |
last_event_at |
last_event_at |
Timestamp indicating when the last event related to the impression or element occurred. |
dimension |
last_fixation_at |
last_fixation_at |
Timestamp indicating when the participant’s gaze last fixated on the element or impression. |
dimension |
last_pixel_inview_at |
last_pixel_inview_at |
Timestamp indicating when the element or impression last had at least one pixel visible on the screen. |
dimension |
market |
market |
The specific geographic or demographic market segment targeted for data collection. |
dimension |
session_id |
session_id |
A unique identifier for a participant’s entire viewing session. |
dimension |
time_in_screen |
time_in_screen |
The total duration, in milliseconds, that the element or impression was visible on the screen. |
metric |
total_fixation_duration_ms |
total_fixation_duration_ms |
The cumulative duration, in milliseconds, that a participant’s gaze fixated on the element or impression. This is similar to ‘Time viewed’ for an AOI. |
metric |
width |
width |
The width of the tracked content element or advertisement, measured in pixels. |
metric |