Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
Events_EventActionDimension

The action performed by the user within an event, such as 'Play' or 'Click'.

Events_EventCategoryDimension

The category to which an event belongs, such as 'Videos' or 'Music'.

Events_EventNameDimension

The name of the event, providing more specific detail about the event, such as a video title.

actionsMetric

The total number of actions (page views, outlinks, downloads) performed during a visit.

avg_event_valueMetric

The average value associated with events that have a defined numeric value.

avg_page_load_timeMetric

The average time, in seconds, it takes for a page to fully load in the user's browser.

avg_time_dom_completionMetric

The average time it takes for the Document Object Model (DOM) to be ready, indicating when the page structure is loaded.

avg_time_dom_processingMetric

The average time spent by the browser processing the Document Object Model (DOM) of a page.

avg_time_networkMetric

The average time spent on network requests to fetch page resources.

avg_time_on_loadMetric

The average time it takes for all resources on a page to fully load, including images and scripts.

avg_time_on_pageMetric

The average time, in seconds, visitors spend viewing a specific page.

avg_time_serverMetric

The average time taken by the server to respond to page requests.

avg_time_transferMetric

The average time spent transferring data for a page.

bounce_countMetric

The number of visits that bounced (viewed only one page) on the website.

bounce_count_percent_of_totalMetric

The percentage of total bounced visits that this row represents, indicating the proportion of single-page visits relative to the total bounced visits in the report.

bounce_rateMetric

The percentage of visits that leave the website after viewing only one page.

browserDimension

The name and version of the web browser used by the visitor.

browserCodeDimension

A short code representing the web browser used by the visitor.

browserFamilyDimension

The family of the web browser used by the visitor (e.g., Chromium, Gecko).

browserFamilyDescriptionDimension

A description of the browser family used by the visitor.

browserIconDimension

The URL to an icon representing the web browser used by the visitor.

browserNameDimension

The specific name of the web browser used by the visitor.

browserVersionMetric

The version number of the web browser used by the visitor.

campaignContentDimension

The specific content of an ad or link within a marketing campaign.

campaignGroupDimension

The group to which a marketing campaign belongs, used for organizing and analyzing related campaigns.

campaignIdDimension

A unique identifier for a marketing campaign.

campaignKeywordDimension

The keyword associated with a marketing campaign.

campaignMediumDimension

The marketing medium used for the campaign, such as 'email' or 'cpc'.

campaignNameDimension

The name of the marketing campaign that referred a visitor.

campaignPlacementDimension

The placement of the marketing campaign, such as an ad position or specific section.

campaignSourceDimension

The source of the marketing campaign, such as 'google' or 'newsletter'.

categoryDimension

The category assigned to an event or content being tracked (e.g., 'Videos', 'Buttons').

cityDimension

The city from which the visitor accessed the website, based on their IP address.

city_nameDimension

The city from which the visitor accessed the website.

contentInteractionDimension

The type of interaction a user had with specific content (e.g., 'click', 'play', 'view').

contentNameDimension

The descriptive name or title of the content being tracked.

contentPieceDimension

A specific piece or segment of content that was interacted with.

contentTargetDimension

The target or destination associated with a content interaction, often a URL.

continentDimension

The continent from which the visitor accessed the website, based on their IP address.

continentCodeDimension

A short code representing the continent from which the visitor accessed the website.

convertedMetric

Indicates whether a visit resulted in a goal conversion.

countryDimension

The country from which the visitor accessed the website, based on their IP address.

countryCodeDimension

A two-letter code representing the country from which the visitor accessed the website.

countryFlagDimension

The URL to an image of the flag of the visitor's country.

country_nameDimension

The country from which the visitor accessed the website.

crashEventIdMetric

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).

crashIdMetric

A unique identifier for a specific crash event recorded on the website.

crashTypeDimension

The type or category of a crash that occurred, available in crash analytics reports.

crashesMetric

The total number of crashes recorded on the website.

customVariablesDimension

User-defined key-value pairs that can be associated with visits or actions for custom data tracking.

dateDimension

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.

datetimeLastReappearedDimension

The date and time when a previously disappeared crash reappeared on the website.

datetimeLastSeenDimension

The date and time when a specific crash was last observed on the website.

daysSinceFirstVisitMetric

The number of days that have passed since the visitor's very first visit to the website.

daysSinceLastEcommerceOrderMetric

The number of days that have passed since the visitor's last e-commerce order.

daysSinceLastVisitMetric

The number of days that have passed since the visitor's last visit to the website.

deviceBrandDimension

The brand of the device (e.g., Apple, Samsung) used by the visitor.

deviceModelDimension

The specific model of the device (e.g., iPhone 15, Galaxy S23) used by the visitor.

deviceTypeDimension

The type of device used by the visitor (e.g., Desktop, Mobile, Tablet).

deviceTypeIconDimension

The URL to an icon representing the type of device used by the visitor.

dimension1Dimension

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).

dimension2Dimension

A custom dimension field used for tracking user-defined data beyond standard metrics.

dimension4Dimension

A custom dimension field used for tracking user-defined data beyond standard metrics.

dimension5Dimension

A custom dimension field used for tracking user-defined data beyond standard metrics.

entry_bounce_countMetric

The number of visits that started on this page and bounced (viewed only one page).

entry_nb_actionsMetric

The number of page views for visits that started on this page.

entry_nb_uniq_visitorsMetric

The number of unique visitors whose visit started on this page.

entry_nb_visitsMetric

The number of visits that started on this page.

entry_sum_visit_lengthMetric

The total time, in seconds, spent by visits that started on this page.

eventActionDimension

The action performed by the user within an event, such as 'Play' or 'Click'.

eventCategoryDimension

The category to which an event belongs, such as 'Videos' or 'Music'.

eventNameDimension

The name of the event, providing more specific detail about the event, such as a video title.

eventValueMetric

A numerical value assigned to an event, often used for tracking monetary value or points.

eventsMetric

A list or count of events that occurred during a session.

exit_nb_uniq_visitorsMetric

The number of unique visitors whose visit ended on this page.

exit_nb_visitsMetric

The number of visits that finished on this page.

exit_rateMetric

The percentage of visits that exited the website from this page without viewing any other pages.

experimentsDimension

Information related to A/B tests or other experiments a visitor was part of.

fieldsDimension

A collection of form fields and their associated analytics data.

firstActionTimestampMetric

The Unix timestamp of the first action performed during a visit.

formConversionsMetric

The number of conversions related to form submissions.

formIdMetric

A unique identifier for a specific form on the website.

formNameDimension

The name of a specific form on the website, used for identification in form analytics reports.

formStatusDimension

The status of a form, such as active, paused, or archived.

fullscreenMetric

A flag indicating whether media (like videos) was viewed in fullscreen mode during a user's visit.

goal.nb_conv_pages_beforeMetric

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_conversionsMetric

The total number of times a specific goal has been achieved or converted.

goal.nb_conversions_attribMetric

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_entryMetric

The total number of goal conversions that occurred within visits where a specific page was the entry point.

goal.nb_conversions_entry_rateMetric

The rate at which visits, where a specific page was the entry point, resulted in a goal conversion.

goal.nb_conversions_page_rateMetric

The rate at which views of a specific page led to a goal conversion.

goal.nb_conversions_page_uniqMetric

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_convertedMetric

The number of unique visits during which at least one goal conversion occurred.

goal.revenueMetric

The total monetary value generated from all goal conversions.

goal.revenue_attribMetric

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_entryMetric

The total revenue generated from goal conversions that occurred within visits where a specific page was the entry point.

goal.revenue_per_entryMetric

The average revenue generated per visit where a specific page was the entry point and a goal conversion occurred.

goalConversionsMetric

A list or count of all goal conversions that occurred during a visit.

goalIdMetric

A unique identifier for a conversion goal.

goalNameDimension

The name of the conversion goal configured in Matomo.

idSiteMetric

A unique integer identifier for the website being tracked in Matomo.

idVisitMetric

A unique identifier for a specific visitor session.

idgoalDimension

The unique identifier for a specific goal within Matomo.

idpageviewDimension

A unique identifier for a specific page view within a visit.

idsiteMetric

A unique integer identifier for the website being tracked in Matomo.

idsubdatatableMetric

An identifier used to request a sub-table of a given report row, providing more detailed breakdown of data.

itemDetailsDimension

Detailed information about items in an e-commerce order or abandoned cart, such as SKU, name, and quantity.

itemsMetric

A list or count of items involved in an e-commerce transaction.

labelDimension

A generic label for a row in a report, often representing a dimension value such as a page title or campaign name.

languageDimension

The language setting of the visitor's browser or operating system.

languageCodeDimension

A two-letter code representing the language setting of the visitor's browser or operating system.

lastActionDateTimeDimension

The date and time of the last action performed during a visit.

lastActionTimestampMetric

The Unix timestamp of the last action performed during a visit.

latMetric

The latitude coordinate of the visitor's geographic location.

latitudeMetric

The geographical latitude of the visitor's location.

locationDimension

The geographical location (city, region, country) of the visitor.

logoDimension

The URL of a logo associated with a specific entity in a report, such as a search engine or a social media platform.

longMetric

The longitude coordinate of the visitor's geographic location.

longitudeMetric

The geographical longitude of the visitor's location.

max_actionsMetric

The maximum number of actions (page views, outlinks, downloads) performed within a single visit.

max_event_valueMetric

The maximum value associated with events that have a defined numeric value.

max_time_dom_completionMetric

The maximum time it took for the Document Object Model (DOM) to be ready on a page.

max_time_dom_processingMetric

The maximum time spent by the browser processing the Document Object Model (DOM) of a page.

max_time_networkMetric

The maximum time spent on network requests to fetch page resources.

max_time_on_loadMetric

The maximum time it took for all resources on a page to fully load.

max_time_serverMetric

The maximum time taken by the server to respond to a page request.

max_time_transferMetric

The maximum time spent transferring data for a page.

media_lengthMetric

The total duration of a media item (video or audio) in seconds.

media_progressMetric

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_titleDimension

The title of the media item (video or audio) being consumed by the visitor.

media_typeDimension

The type of media being consumed, such as 'video' or 'audio'.

messageDimension

The error message associated with a crash event.

min_event_valueDimension

The minimum value associated with events that have a defined numeric value.

min_time_dom_completionMetric

The minimum time it took for the Document Object Model (DOM) to be ready on a page.

min_time_dom_processingMetric

The minimum time spent by the browser processing the Document Object Model (DOM) of a page.

min_time_networkMetric

The minimum time spent on network requests to fetch page resources.

min_time_on_loadMetric

The minimum time it took for all resources on a page to fully load.

min_time_serverMetric

The minimum time taken by the server to respond to a page request.

min_time_transferMetric

The minimum time spent transferring data for a page.

nb_actionsMetric

The total number of actions (page views, outlinks, downloads) performed by visitors on the website.

nb_actions_percent_of_totalMetric

The percentage of the report's total actions (including page views, internal site searches, outlinks, and downloads) that this specific row or segment represents.

nb_conversionsMetric

The total number of goal conversions across all goals.

nb_conversions_percent_of_totalMetric

The percentage of the report's total goal conversions that this specific row or segment represents.

nb_eventsMetric

The total number of custom events tracked.

nb_events_with_valueMetric

The number of custom events that had a numeric value assigned to them.

nb_hitsMetric

The total number of times a page or resource was viewed or accessed.

nb_hits_following_searchMetric

The number of page views that occurred after a site search was performed.

nb_hits_with_time_dom_completionMetric

The number of page views for which the DOM completion time was recorded.

nb_hits_with_time_dom_processingMetric

The number of page views for which the DOM processing time was recorded.

nb_hits_with_time_networkMetric

The number of page views for which the network time was recorded.

nb_hits_with_time_on_loadMetric

The number of page views for which the full page load time was recorded.

nb_hits_with_time_serverMetric

The number of page views for which the server response time was recorded.

nb_hits_with_time_transferMetric

The number of page views for which the data transfer time was recorded.

nb_uniq_visitorsMetric

The total number of unique visitors to the website.

nb_usersMetric

The number of unique active users, identified by their User ID. This metric is zero if User ID tracking is not enabled.

nb_visitsMetric

The total number of visits to the website. A new visit is recorded after 30 minutes of user inactivity.

nb_visits_convertedMetric

The total number of visits during which at least one goal conversion occurred.

nb_visits_converted_percent_of_totalMetric

The percentage of the report's total visits that resulted in at least one goal conversion, represented by this specific row or segment.

nb_visits_percent_of_totalMetric

The percentage of the report's total visits that this specific row or segment represents.

operatingSystemDimension

The name and version of the operating system used by the visitor.

operatingSystemCodeDimension

A short code representing the operating system used by the visitor.

operatingSystemIconDimension

The URL to an icon representing the operating system used by the visitor.

operatingSystemNameDimension

The specific name of the operating system used by the visitor.

operatingSystemVersionDimension

The version number of the operating system used by the visitor.

orderIdDimension

A unique identifier for an e-commerce order.

pageIdMetric

A unique identifier for a specific page on the website.

pageLoadTimeDimension

The time, in seconds, it takes for a page to fully load in the user's browser.

pageLoadTimeMillisecondsMetric

The time, in milliseconds, it takes for a page to fully load in the user's browser.

pageTitleDimension

The title of the page as it appears in the browser's title bar or tab.

pageviewPositionMetric

The sequential position of a page view within a visitor's session.

player_nameDimension

The name of the media player used to consume video or audio content.

pluginsDimension

A list of browser plugins detected for the visitor.

pluginsIconsDimension

The URLs to icons representing the browser plugins detected for the visitor.

referer_typeMetric

The classification of the referrer that led a visitor to the website, such as 'Direct Entry', 'Search Engines', 'Websites', or 'Social Networks'.

referrerKeywordDimension

The search keyword used by the visitor to find the website through a search engine.

referrerKeywordPositionMetric

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.

referrerNameDimension

The name of the referrer, such as a search engine name, website name, or social network name.

referrerSearchEngineIconDimension

The URL to an icon representing the search engine that referred the visitor.

referrerSearchEngineUrlDimension

The URL of the search engine that referred the visitor.

referrerSocialNetworkIconDimension

The URL to an icon representing the social network that referred the visitor.

referrerSocialNetworkUrlDimension

The URL of the social network that referred the visitor.

referrerTypeDimension

The type of referrer that directed the visitor to the website, such as 'Search Engine', 'Website', or 'Social Network'.

referrerTypeNameDimension

The descriptive name of the referrer type, such as 'Direct Entry' or 'Websites'.

referrerUrlDimension

The full URL of the website that referred the visitor.

referrer_typeMetric

The type of referrer that directed the visitor to the website, such as 'Search Engine', 'Website', or 'Social Network'.

regionDimension

The geographical region or state from which the visitor accessed the website.

regionCodeDimension

A short code representing the geographical region or state from which the visitor accessed the website.

region_nameDimension

The region, state, or province from which the visitor accessed the website.

resolutionDimension

The screen resolution of the device used by the visitor.

resourceUriDimension

The Uniform Resource Identifier (URI) of the file or resource where an error or crash occurred.

revenueMetric

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.

revenueDiscountMetric

The total discount amount applied to an e-commerce order.

revenueShippingMetric

The total shipping cost for an e-commerce order.

revenueSubTotalMetric

The subtotal revenue of an e-commerce order before tax, shipping, and discounts.

revenueTaxMetric

The total tax amount applied to an e-commerce order.

revenue_percent_of_totalMetric

The percentage of the report's total revenue from goal conversions or product sales that this specific row or segment represents.

searchesMetric

The total number of searches performed on the website's internal search engine.

secondsSinceFirstVisitMetric

The number of seconds that have passed since the visitor's very first visit to the website.

secondsSinceLastEcommerceOrderMetric

The number of seconds that have passed since the visitor's last e-commerce order.

secondsSinceLastVisitMetric

The number of seconds that have passed since the visitor's last visit to the website.

segmentDimension

A custom segment applied to filter reports, allowing analysis of specific subsets of visitor data.

serverDateDimension

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.

serverDatePrettyDimension

A human-readable format of the server date.

serverDatePrettyFirstActionDimension

A human-readable format of the server date of the visitor's first action.

serverTimePrettyDimension

A human-readable format of the server time.

serverTimePrettyFirstActionDimension

A human-readable format of the server time of the visitor's first action.

serverTimestampMetric

The Unix timestamp of when the data was recorded on the server.

sessionReplayUrlDimension

A URL to a recording of a user session, providing visual replay of user interactions.

siteCurrencyDimension

The currency used for the website's e-commerce transactions.

siteCurrencySymbolDimension

The symbol for the currency used for the website's e-commerce transactions.

siteNameDimension

The name of the website being tracked.

siteSearchCategoryDimension

The category applied to a site search, if categorized.

siteSearchCountMetric

The number of times a specific site search keyword or category was searched.

siteSearchKeywordDimension

The keyword entered by a user into the website's internal search engine.

submittedMetric

Indicates whether a form has been submitted.

sum_event_valueMetric

The total sum of values across all custom events that had a numeric value.

sum_time_spentMetric

The total time, in seconds, visitors spent on a specific page.

sum_visit_lengthMetric

The total duration, in seconds, of all visits to the website.

timeHesitationMetric

The time, in seconds, a user hesitated (waited) before interacting with a form field.

timeSpentMetric

The total time, in seconds, a visitor spent on a particular page or during a specific action.

timeSpentPrettyDimension

A human-readable format of the time spent on a page or during a visit.

timeToFirstSubmissionMetric

The time, in seconds, taken by a user to make their first submission on a form.

time_to_initial_playMetric

The duration, in seconds, from when a media item loaded until the user initiated its playback.

timestampDimension

The Unix timestamp of when the event or action occurred.

titleDimension

The title of the page or content viewed by the visitor.

totalAbandonedCartsMetric

The total number of e-commerce carts that were abandoned.

totalAbandonedCartsItemsMetric

The total number of items left in abandoned e-commerce carts.

totalAbandonedCartsRevenueMetric

The potential revenue lost from abandoned e-commerce carts.

totalEcommerceConversionsMetric

The total number of e-commerce conversions (orders).

totalEcommerceItemsMetric

The total number of items purchased in e-commerce orders.

totalEcommerceRevenueMetric

The total revenue generated from all e-commerce activities on the website.

urlDimension

The full Uniform Resource Locator (URL) of the page or resource.

userIdDimension

A unique identifier assigned to a specific user, enabling tracking across sessions and devices.

visitConvertedMetric

Indicates whether a visitor's session successfully achieved a defined goal or conversion.

visitConvertedIconDimension

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.

visitCountMetric

The total number of times a specific user has visited the website.

visitDurationMetric

The total duration, in seconds, of a user's visit to the website, from their first action to their last action.

visitDurationPrettyDimension

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).

visitEcommerceStatusDimension

The e-commerce status of a visit, indicating if the session involved e-commerce activities such as product views or purchases.

visitEcommerceStatusIconDimension

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.

visitIpDimension

The IP address of the visitor during their session.

visitLocalHourMetric

The hour of the visit, adjusted to the visitor's local time zone.

visitLocalTimeDimension

The exact time of the visit, adjusted to the visitor's local time zone.

visitServerHourMetric

The hour of the visit, based on the server's time zone.

visitorIdDimension

A unique identifier assigned to a specific visitor for tracking their activity across sessions.

visitorTypeDimension

The classification of the visitor, such as 'new visitor' or 'returning visitor'.

visitorTypeIconDimension

An icon or indicator representing the type of visitor (e.g., new visitor or returning visitor).

watched_timeMetric

The total duration, in seconds, that a user has actively watched or listened to media content on the website.

websiteDimension

The name of the website being tracked.

website_idDimension

A unique integer identifier for the website being tracked in Matomo.