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