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
accessibility_metadata.image_elements	accessibility_metadata.image_elements	Represents data related to image elements within the tracked content, used for detailed attention analysis.	dimension
accessibility_metadata.layout_elements	accessibility_metadata.layout_elements	Represents data related to structural or layout elements within the tracked content, used for detailed attention analysis.	dimension
accessibility_metadata.text_elements	accessibility_metadata.text_elements	Represents data related to text elements within the tracked content, used for detailed attention analysis.	dimension
accessibility_metadata.video_elements	accessibility_metadata.video_elements	Represents data related to video elements within the tracked content, used for detailed attention analysis.	dimension
accessibility_metadata.web_view_elements	accessibility_metadata.web_view_elements	Represents data related to web view elements, such as embedded web content, within the tracked content, used for detailed attention analysis.	dimension
ad_full_height	ad_full_height	The full height of the advertisement in pixels.	metric
ad_full_width	ad_full_width	The full width of the advertisement in pixels.	metric
ad_placement	ad_placement	Describes the position or location where the advertisement was displayed on the screen.	dimension
ad_technical_format	ad_technical_format	The technical format or type of the advertisement, e.g., display, video, interstitial.	dimension
brand	brand	The brand associated with the advertisement or content being tracked.	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
device.android_sdk	device.android_sdk	The Android SDK version running on the device used for data collection.	metric
device.android_version	device.android_version	The Android operating system version of the device used for data collection.	metric
device.brand	device.brand	The brand name of the device used for data collection (e.g., Samsung, Google).	dimension
device.cpu_cores	device.cpu_cores	The number of CPU cores in the device’s processor.	metric
device.cpu_max_cpu_freq_ghz	device.cpu_max_cpu_freq_ghz	The maximum CPU frequency of the device’s processor in GHz.	metric
device.cpu_model	device.cpu_model	The model name of the device’s CPU.	dimension
device.display	device.display	General information about the device’s display, such as resolution or type.	dimension
device.manufacturer	device.manufacturer	The manufacturer of the device used for data collection.	dimension
device.model	device.model	The specific model of the device used for data collection.	dimension
device.product	device.product	The product name of the device used for data collection.	dimension
display_info.density	display_info.density	The logical density of the display.	metric
display_info.density_dpi	display_info.density_dpi	The screen density expressed as dots per inch (dpi).	metric
display_info.height_pixels	display_info.height_pixels	The height of the display in pixels.	metric
display_info.scaled_density	display_info.scaled_density	The scaled pixel density of the device’s display screen where the content was viewed.	metric
display_info.width_pixels	display_info.width_pixels	The width of the display in pixels.	metric
display_info.x_dpi	display_info.x_dpi	The exact physical pixels per inch of the screen in the X dimension.	metric
display_info.y_dpi	display_info.y_dpi	The exact physical pixels per inch of the screen in the Y dimension.	metric
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 element or the overall content being measured in pixels.	metric
hostname	hostname	The hostname of the website or digital content being viewed by the panelist.	dimension
hrefs	hrefs	A list of hyperlinks (URLs) present within the viewed content or advertisement.	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	A boolean indicating whether the advertisement met the Interactive Advertising Bureau’s (IAB) viewability standards for an ‘in-view’ impression.	dimension
is_native	is_native	A boolean indicating whether the advertisement is a native ad, designed to blend with the surrounding content.	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
package_name	package_name	The identifier of the application or environment in which the content was displayed.	dimension
panelist_id	panelist_id	A unique identifier assigned to the participant (panelist) whose eye-tracking data is being collected.	dimension
screen.height	screen.height	The height of the device’s screen in pixels.	metric
screen.orientation	screen.orientation	The orientation of the device’s screen (e.g., portrait, landscape).	dimension
screen.width	screen.width	The width of the device’s screen in pixels.	metric
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
type	type	The classification or category of the data record, ad, or specific element being described.	dimension
version.application	version.application	The version number of the application collecting the data.	metric
version.data	version.data	The version number or schema version of the data being collected.	metric
version.script	version.script	The version number of the script or SDK used for data collection.	dimension
width	width	The width of the tracked element or the overall content being measured in pixels.	metric