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