Matomo: Most-used fields

The table below gives information about most-used fields that you can import from Matomo. 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
Events_EventAction	Events_EventAction	The action performed by the user within an event, such as ‘Play’ or ‘Click’.	dimension
Events_EventCategory	Events_EventCategory	The category to which an event belongs, such as ‘Videos’ or ‘Music’.	dimension
Events_EventName	Events_EventName	The name of the event, providing more specific detail about the event, such as a video title.	dimension
actions	actions	The total number of actions (page views, outlinks, downloads) performed during a visit.	metric
avg_event_value	avg_event_value	The average value associated with events that have a defined numeric value.	metric
avg_page_load_time	avg_page_load_time	The average time, in seconds, it takes for a page to fully load in the user’s browser.	metric
avg_time_dom_completion	avg_time_dom_completion	The average time it takes for the Document Object Model (DOM) to be ready, indicating when the page structure is loaded.	metric
avg_time_dom_processing	avg_time_dom_processing	The average time spent by the browser processing the Document Object Model (DOM) of a page.	metric
avg_time_network	avg_time_network	The average time spent on network requests to fetch page resources.	metric
avg_time_on_load	avg_time_on_load	The average time it takes for all resources on a page to fully load, including images and scripts.	metric
avg_time_on_page	avg_time_on_page	The average time, in seconds, visitors spend viewing a specific page.	metric
avg_time_server	avg_time_server	The average time taken by the server to respond to page requests.	metric
avg_time_transfer	avg_time_transfer	The average time spent transferring data for a page.	metric
bounce_count	bounce_count	The number of visits that bounced (viewed only one page) on the website.	metric
bounce_rate	bounce_rate	The percentage of visits that leave the website after viewing only one page.	metric
browser	browser	The name and version of the web browser used by the visitor.	dimension
browserCode	browserCode	A short code representing the web browser used by the visitor.	dimension
browserFamily	browserFamily	The family of the web browser used by the visitor (e.g., Chromium, Gecko).	dimension
browserFamilyDescription	browserFamilyDescription	A description of the browser family used by the visitor.	dimension
browserIcon	browserIcon	The URL to an icon representing the web browser used by the visitor.	dimension
browserName	browserName	The specific name of the web browser used by the visitor.	dimension
browserVersion	browserVersion	The version number of the web browser used by the visitor.	metric
campaignContent	campaignContent	The specific content of an ad or link within a marketing campaign.	dimension
campaignGroup	campaignGroup	The group to which a marketing campaign belongs, used for organizing and analyzing related campaigns.	dimension
campaignId	campaignId	A unique identifier for a marketing campaign.	dimension
campaignKeyword	campaignKeyword	The keyword associated with a marketing campaign.	dimension
campaignMedium	campaignMedium	The marketing medium used for the campaign, such as ‘email’ or ‘cpc’.	dimension
campaignName	campaignName	The name of the marketing campaign that referred a visitor.	dimension
campaignPlacement	campaignPlacement	The placement of the marketing campaign, such as an ad position or specific section.	dimension
campaignSource	campaignSource	The source of the marketing campaign, such as ‘google’ or ‘newsletter’.	dimension
category	category	The category assigned to an event or content being tracked (e.g., ‘Videos’, ‘Buttons’).	dimension
city	city	The city from which the visitor accessed the website, based on their IP address.	dimension
city_name	city_name	The city from which the visitor accessed the website.	dimension
contentInteraction	contentInteraction	The type of interaction a user had with specific content (e.g., ‘click’, ‘play’, ‘view’).	dimension
contentName	contentName	The descriptive name or title of the content being tracked.	dimension
contentPiece	contentPiece	A specific piece or segment of content that was interacted with.	dimension
contentTarget	contentTarget	The target or destination associated with a content interaction, often a URL.	dimension
continent	continent	The continent from which the visitor accessed the website, based on their IP address.	dimension
continentCode	continentCode	A short code representing the continent from which the visitor accessed the website.	dimension
converted	converted	Indicates whether a visit resulted in a goal conversion.	metric
country	country	The country from which the visitor accessed the website, based on their IP address.	dimension
countryCode	countryCode	A two-letter code representing the country from which the visitor accessed the website.	dimension
countryFlag	countryFlag	The URL to an image of the flag of the visitor’s country.	dimension
country_name	country_name	The country from which the visitor accessed the website.	dimension
crashEventId	crashEventId	This field represents a unique identifier for a specific crash event recorded within Matomo’s Crash Analytics module. It can be used to retrieve detailed information about the crash or manage its status (e.g., ignore/unignore).	metric
crashId	crashId	A unique identifier for a specific crash event recorded on the website.	metric
crashType	crashType	The type or category of a crash that occurred, available in crash analytics reports.	dimension
crashes	crashes	The total number of crashes recorded on the website.	metric
customVariables	customVariables	User-defined key-value pairs that can be associated with visits or actions for custom data tracking.	dimension
date	date	The specific date or date range for which the data is being reported or analyzed. Matomo uses YYYY-MM-DD format or magic keywords like today, yesterday, lastWeek, lastMonth, lastYear.	dimension
datetimeLastReappeared	datetimeLastReappeared	The date and time when a previously disappeared crash reappeared on the website.	dimension
datetimeLastSeen	datetimeLastSeen	The date and time when a specific crash was last observed on the website.	dimension
daysSinceFirstVisit	daysSinceFirstVisit	The number of days that have passed since the visitor’s very first visit to the website.	metric
daysSinceLastEcommerceOrder	daysSinceLastEcommerceOrder	The number of days that have passed since the visitor’s last e-commerce order.	metric
daysSinceLastVisit	daysSinceLastVisit	The number of days that have passed since the visitor’s last visit to the website.	metric
deviceBrand	deviceBrand	The brand of the device (e.g., Apple, Samsung) used by the visitor.	dimension
deviceModel	deviceModel	The specific model of the device (e.g., iPhone 15, Galaxy S23) used by the visitor.	dimension
deviceType	deviceType	The type of device used by the visitor (e.g., Desktop, Mobile, Tablet).	dimension
deviceTypeIcon	deviceTypeIcon	The URL to an icon representing the type of device used by the visitor.	dimension
dimension1	dimension1	Represents a custom dimension value. Matomo allows defining custom dimensions to track specific data points relevant to your website or business, beyond the standard metrics. These can be configured with different scopes (e.g., visit or action).	dimension
dimension2	dimension2	A custom dimension field used for tracking user-defined data beyond standard metrics.	dimension
dimension4	dimension4	A custom dimension field used for tracking user-defined data beyond standard metrics.	dimension
dimension5	dimension5	A custom dimension field used for tracking user-defined data beyond standard metrics.	dimension
entry_bounce_count	entry_bounce_count	The number of visits that started on this page and bounced (viewed only one page).	metric
entry_nb_actions	entry_nb_actions	The number of page views for visits that started on this page.	metric
entry_nb_uniq_visitors	entry_nb_uniq_visitors	The number of unique visitors whose visit started on this page.	metric
entry_nb_visits	entry_nb_visits	The number of visits that started on this page.	metric
entry_sum_visit_length	entry_sum_visit_length	The total time, in seconds, spent by visits that started on this page.	metric
eventAction	eventAction	The action performed by the user within an event, such as ‘Play’ or ‘Click’.	dimension
eventCategory	eventCategory	The category to which an event belongs, such as ‘Videos’ or ‘Music’.	dimension
eventName	eventName	The name of the event, providing more specific detail about the event, such as a video title.	dimension
eventValue	eventValue	A numerical value assigned to an event, often used for tracking monetary value or points.	metric
events	events	A list or count of events that occurred during a session.	metric
exit_nb_uniq_visitors	exit_nb_uniq_visitors	The number of unique visitors whose visit ended on this page.	metric
exit_nb_visits	exit_nb_visits	The number of visits that finished on this page.	metric
exit_rate	exit_rate	The percentage of visits that exited the website from this page without viewing any other pages.	metric
experiments	experiments	Information related to A/B tests or other experiments a visitor was part of.	dimension
fields	fields	A collection of form fields and their associated analytics data.	dimension
firstActionTimestamp	firstActionTimestamp	The Unix timestamp of the first action performed during a visit.	metric
formConversions	formConversions	The number of conversions related to form submissions.	metric
formId	formId	A unique identifier for a specific form on the website.	metric
formName	formName	The name of a specific form on the website, used for identification in form analytics reports.	dimension
formStatus	formStatus	The status of a form, such as active, paused, or archived.	dimension
fullscreen	fullscreen	A flag indicating whether media (like videos) was viewed in fullscreen mode during a user’s visit.	metric
goalConversions	goalConversions	A list or count of all goal conversions that occurred during a visit.	metric
goalId	goalId	A unique identifier for a conversion goal.	metric
goalName	goalName	The name of the conversion goal configured in Matomo.	dimension
idSite	idSite	A unique integer identifier for the website being tracked in Matomo.	metric
idVisit	idVisit	A unique identifier for a specific visitor session.	metric
idpageview	idpageview	A unique identifier for a specific page view within a visit.	dimension
idsite	idsite	A unique integer identifier for the website being tracked in Matomo.	metric
idsubdatatable	idsubdatatable	An identifier used to request a sub-table of a given report row, providing more detailed breakdown of data.	metric
itemDetails	itemDetails	Detailed information about items in an e-commerce order or abandoned cart, such as SKU, name, and quantity.	dimension
items	items	A list or count of items involved in an e-commerce transaction.	metric
label	label	A generic label for a row in a report, often representing a dimension value such as a page title or campaign name.	dimension
language	language	The language setting of the visitor’s browser or operating system.	dimension
languageCode	languageCode	A two-letter code representing the language setting of the visitor’s browser or operating system.	dimension
lastActionDateTime	lastActionDateTime	The date and time of the last action performed during a visit.	dimension
lastActionTimestamp	lastActionTimestamp	The Unix timestamp of the last action performed during a visit.	metric
lat	lat	The latitude coordinate of the visitor’s geographic location.	metric
latitude	latitude	The geographical latitude of the visitor’s location.	metric
leftBlank	leftBlank	Represents the count of times a specific form field or tracked data point was left empty by a user or within the data collection process. This can indicate fields that are unneeded or causing user friction.	metric
location	location	The geographical location (city, region, country) of the visitor.	dimension
logo	logo	The URL of a logo associated with a specific entity in a report, such as a search engine or a social media platform.	dimension
long	long	The longitude coordinate of the visitor’s geographic location.	metric
longitude	longitude	The geographical longitude of the visitor’s location.	metric
max_actions	max_actions	The maximum number of actions (page views, outlinks, downloads) performed within a single visit.	metric
max_event_value	max_event_value	The maximum value associated with events that have a defined numeric value.	metric
max_time_dom_completion	max_time_dom_completion	The maximum time it took for the Document Object Model (DOM) to be ready on a page.	metric
max_time_dom_processing	max_time_dom_processing	The maximum time spent by the browser processing the Document Object Model (DOM) of a page.	metric
max_time_network	max_time_network	The maximum time spent on network requests to fetch page resources.	metric
max_time_on_load	max_time_on_load	The maximum time it took for all resources on a page to fully load.	metric
max_time_server	max_time_server	The maximum time taken by the server to respond to a page request.	metric
max_time_transfer	max_time_transfer	The maximum time spent transferring data for a page.	metric
media_length	media_length	The total duration of a media item (video or audio) in seconds.	metric
media_progress	media_progress	Tracks the progress of a user’s interaction with a media item, such as a video or audio file. This can be derived from metrics like the total time watched or the percentage of content consumed.	metric
media_title	media_title	The title of the media item (video or audio) being consumed by the visitor.	dimension
media_type	media_type	The type of media being consumed, such as ‘video’ or ‘audio’.	dimension
message	message	The error message associated with a crash event.	dimension
min_event_value	min_event_value	The minimum value associated with events that have a defined numeric value.	dimension
min_time_dom_completion	min_time_dom_completion	The minimum time it took for the Document Object Model (DOM) to be ready on a page.	metric
min_time_dom_processing	min_time_dom_processing	The minimum time spent by the browser processing the Document Object Model (DOM) of a page.	metric
min_time_network	min_time_network	The minimum time spent on network requests to fetch page resources.	metric
min_time_on_load	min_time_on_load	The minimum time it took for all resources on a page to fully load.	metric
min_time_server	min_time_server	The minimum time taken by the server to respond to a page request.	metric
min_time_transfer	min_time_transfer	The minimum time spent transferring data for a page.	metric
nb_actions	nb_actions	The total number of actions (page views, outlinks, downloads) performed by visitors on the website.	metric
nb_conversions	nb_conversions	The total number of goal conversions across all goals.	metric
nb_events	nb_events	The total number of custom events tracked.	metric
nb_events_with_value	nb_events_with_value	The number of custom events that had a numeric value assigned to them.	metric
nb_hits	nb_hits	The total number of times a page or resource was viewed or accessed.	metric
nb_hits_following_search	nb_hits_following_search	The number of page views that occurred after a site search was performed.	metric
nb_hits_with_time_dom_completion	nb_hits_with_time_dom_completion	The number of page views for which the DOM completion time was recorded.	metric
nb_hits_with_time_dom_processing	nb_hits_with_time_dom_processing	The number of page views for which the DOM processing time was recorded.	metric
nb_hits_with_time_network	nb_hits_with_time_network	The number of page views for which the network time was recorded.	metric
nb_hits_with_time_on_load	nb_hits_with_time_on_load	The number of page views for which the full page load time was recorded.	metric
nb_hits_with_time_server	nb_hits_with_time_server	The number of page views for which the server response time was recorded.	metric
nb_hits_with_time_transfer	nb_hits_with_time_transfer	The number of page views for which the data transfer time was recorded.	metric
nb_uniq_visitors	nb_uniq_visitors	The total number of unique visitors to the website.	metric
nb_users	nb_users	The number of unique active users, identified by their User ID. This metric is zero if User ID tracking is not enabled.	metric
nb_visits	nb_visits	The total number of visits to the website. A new visit is recorded after 30 minutes of user inactivity.	metric
nb_visits_converted	nb_visits_converted	The total number of visits during which at least one goal conversion occurred.	metric
operatingSystem	operatingSystem	The name and version of the operating system used by the visitor.	dimension
operatingSystemCode	operatingSystemCode	A short code representing the operating system used by the visitor.	dimension
operatingSystemIcon	operatingSystemIcon	The URL to an icon representing the operating system used by the visitor.	dimension
operatingSystemName	operatingSystemName	The specific name of the operating system used by the visitor.	dimension
operatingSystemVersion	operatingSystemVersion	The version number of the operating system used by the visitor.	dimension
orderId	orderId	A unique identifier for an e-commerce order.	dimension
pageId	pageId	A unique identifier for a specific page on the website.	metric
pageLoadTime	pageLoadTime	The time, in seconds, it takes for a page to fully load in the user’s browser.	dimension
pageLoadTimeMilliseconds	pageLoadTimeMilliseconds	The time, in milliseconds, it takes for a page to fully load in the user’s browser.	metric
pageTitle	pageTitle	The title of the page as it appears in the browser’s title bar or tab.	dimension
pageviewPosition	pageviewPosition	The sequential position of a page view within a visitor’s session.	metric
player_name	player_name	The name of the media player used to consume video or audio content.	dimension
plugins	plugins	A list of browser plugins detected for the visitor.	dimension
pluginsIcons	pluginsIcons	The URLs to icons representing the browser plugins detected for the visitor.	dimension
referrerKeyword	referrerKeyword	The search keyword used by the visitor to find the website through a search engine.	dimension
referrerKeywordPosition	referrerKeywordPosition	The ranking or position of the keyword that a user searched for on a search engine, which then led them to the website. This field provides insight into search engine performance for specific keywords.	metric
referrerName	referrerName	The name of the referrer, such as a search engine name, website name, or social network name.	dimension
referrerSearchEngineIcon	referrerSearchEngineIcon	The URL to an icon representing the search engine that referred the visitor.	dimension
referrerSearchEngineUrl	referrerSearchEngineUrl	The URL of the search engine that referred the visitor.	dimension
referrerSocialNetworkIcon	referrerSocialNetworkIcon	The URL to an icon representing the social network that referred the visitor.	dimension
referrerSocialNetworkUrl	referrerSocialNetworkUrl	The URL of the social network that referred the visitor.	dimension
referrerType	referrerType	The type of referrer that directed the visitor to the website, such as ‘Search Engine’, ‘Website’, or ‘Social Network’.	dimension
referrerTypeName	referrerTypeName	The descriptive name of the referrer type, such as ‘Direct Entry’ or ‘Websites’.	dimension
referrerUrl	referrerUrl	The full URL of the website that referred the visitor.	dimension
referrer_type	referrer_type	The type of referrer that directed the visitor to the website, such as ‘Search Engine’, ‘Website’, or ‘Social Network’.	metric
region	region	The geographical region or state from which the visitor accessed the website.	dimension
regionCode	regionCode	A short code representing the geographical region or state from which the visitor accessed the website.	dimension
region_name	region_name	The region, state, or province from which the visitor accessed the website.	dimension
resolution	resolution	The screen resolution of the device used by the visitor.	dimension
resourceUri	resourceUri	The Uniform Resource Identifier (URI) of the file or resource where an error or crash occurred.	dimension
revenue	revenue	The total revenue generated from goal conversions. In an e-commerce context, it is the total revenue from product sales, excluding tax, shipping, and discounts.	metric
revenueDiscount	revenueDiscount	The total discount amount applied to an e-commerce order.	metric
revenueShipping	revenueShipping	The total shipping cost for an e-commerce order.	metric
revenueSubTotal	revenueSubTotal	The subtotal revenue of an e-commerce order before tax, shipping, and discounts.	metric
revenueTax	revenueTax	The total tax amount applied to an e-commerce order.	metric
searches	searches	The total number of searches performed on the website’s internal search engine.	metric
secondsSinceFirstVisit	secondsSinceFirstVisit	The number of seconds that have passed since the visitor’s very first visit to the website.	metric
secondsSinceLastEcommerceOrder	secondsSinceLastEcommerceOrder	The number of seconds that have passed since the visitor’s last e-commerce order.	metric
secondsSinceLastVisit	secondsSinceLastVisit	The number of seconds that have passed since the visitor’s last visit to the website.	metric
segment	segment	A custom segment applied to filter reports, allowing analysis of specific subsets of visitor data.	dimension
serverDate	serverDate	The date and time recorded by the server when a visit or action occurred. This timestamp is fundamental for chronological analysis of user activities on the website.	dimension
serverDatePretty	serverDatePretty	A human-readable format of the server date.	dimension
serverDatePrettyFirstAction	serverDatePrettyFirstAction	A human-readable format of the server date of the visitor’s first action.	dimension
serverTimePretty	serverTimePretty	A human-readable format of the server time.	dimension
serverTimePrettyFirstAction	serverTimePrettyFirstAction	A human-readable format of the server time of the visitor’s first action.	dimension
serverTimestamp	serverTimestamp	The Unix timestamp of when the data was recorded on the server.	metric
sessionReplayUrl	sessionReplayUrl	A URL to a recording of a user session, providing visual replay of user interactions.	dimension
siteCurrency	siteCurrency	The currency used for the website’s e-commerce transactions.	dimension
siteCurrencySymbol	siteCurrencySymbol	The symbol for the currency used for the website’s e-commerce transactions.	dimension
siteName	siteName	The name of the website being tracked.	dimension
siteSearchCategory	siteSearchCategory	The category applied to a site search, if categorized.	dimension
siteSearchCount	siteSearchCount	The number of times a specific site search keyword or category was searched.	metric
siteSearchKeyword	siteSearchKeyword	The keyword entered by a user into the website’s internal search engine.	dimension
submitted	submitted	Indicates whether a form has been submitted.	metric
sum_event_value	sum_event_value	The total sum of values across all custom events that had a numeric value.	metric
sum_time_spent	sum_time_spent	The total time, in seconds, visitors spent on a specific page.	metric
sum_visit_length	sum_visit_length	The total duration, in seconds, of all visits to the website.	metric
timeHesitation	timeHesitation	The time, in seconds, a user hesitated (waited) before interacting with a form field.	metric
timeSpent	timeSpent	The total time, in seconds, a visitor spent on a particular page or during a specific action.	metric
timeSpentPretty	timeSpentPretty	A human-readable format of the time spent on a page or during a visit.	dimension
timeToFirstSubmission	timeToFirstSubmission	The time, in seconds, taken by a user to make their first submission on a form.	metric
time_to_initial_play	time_to_initial_play	The duration, in seconds, from when a media item loaded until the user initiated its playback.	metric
timestamp	timestamp	The Unix timestamp of when the event or action occurred.	dimension
title	title	The title of the page or content viewed by the visitor.	dimension
totalAbandonedCarts	totalAbandonedCarts	The total number of e-commerce carts that were abandoned.	metric
totalAbandonedCartsItems	totalAbandonedCartsItems	The total number of items left in abandoned e-commerce carts.	metric
totalAbandonedCartsRevenue	totalAbandonedCartsRevenue	The potential revenue lost from abandoned e-commerce carts.	metric
totalEcommerceConversions	totalEcommerceConversions	The total number of e-commerce conversions (orders).	metric
totalEcommerceItems	totalEcommerceItems	The total number of items purchased in e-commerce orders.	metric
totalEcommerceRevenue	totalEcommerceRevenue	The total revenue generated from all e-commerce activities on the website.	metric
url	url	The full Uniform Resource Locator (URL) of the page or resource.	dimension
userId	userId	A unique identifier assigned to a specific user, enabling tracking across sessions and devices.	dimension
visitConverted	visitConverted	Indicates whether a visitor’s session successfully achieved a defined goal or conversion.	metric
visitConvertedIcon	visitConvertedIcon	Indicates whether a visitor’s session resulted in a conversion of at least one defined goal. This reflects if the visit achieved a desired action, such as a purchase or signup.	dimension
visitCount	visitCount	The total number of times a specific user has visited the website.	metric
visitDuration	visitDuration	The total duration, in seconds, of a user’s visit to the website, from their first action to their last action.	metric
visitDurationPretty	visitDurationPretty	The formatted, human-readable representation of the total length of a visitor’s session on the website (e.g., “1 minute 30 seconds” instead of 90 seconds).	dimension
visitEcommerceStatus	visitEcommerceStatus	The e-commerce status of a visit, indicating if the session involved e-commerce activities such as product views or purchases.	dimension
visitEcommerceStatusIcon	visitEcommerceStatusIcon	Represents the e-commerce status of a visit, such as whether an order was placed, a cart was updated, or an abandoned cart occurred. This field provides a quick visual cue for the outcome of e-commerce related interactions during a visit.	dimension
visitIp	visitIp	The IP address of the visitor during their session.	dimension
visitLocalHour	visitLocalHour	The hour of the visit, adjusted to the visitor’s local time zone.	metric
visitLocalTime	visitLocalTime	The exact time of the visit, adjusted to the visitor’s local time zone.	dimension
visitServerHour	visitServerHour	The hour of the visit, based on the server’s time zone.	metric
visitorId	visitorId	A unique identifier assigned to a specific visitor for tracking their activity across sessions.	dimension
visitorType	visitorType	The classification of the visitor, such as ‘new visitor’ or ‘returning visitor’.	dimension
visitorTypeIcon	visitorTypeIcon	An icon or indicator representing the type of visitor (e.g., new visitor or returning visitor).	dimension
watched_time	watched_time	The total duration, in seconds, that a user has actively watched or listened to media content on the website.	metric
website	website	The name of the website being tracked.	dimension
website_id	website_id	A unique integer identifier for the website being tracked in Matomo.	dimension