Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Piwik PRO: Most-used fields

The table below gives information about most-used fields that you can import from Piwik PRO. 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
bounce_rateMetric

The percentage of sessions where users viewed only one page and exited without further interaction.

bouncesMetric

The total number of sessions that resulted in a bounce (single page view).

browser_engineDimension

The rendering engine used by the user's browser (e.g., WebKit, Gecko).

browser_language_iso639Dimension

The language setting of the user's browser, in ISO 639 format.

browser_versionMetric

The version of the web browser used by the visitor.

campaign_contentDimension

The specific content or ad creative used in a marketing campaign.

campaign_gclidDimension

Google Click ID (Gclid), a URL parameter identifying details of ad clicks from Google Ads campaigns.

campaign_idDimension

The unique identifier of a marketing campaign.

campaign_nameDimension

The name of the campaign associated with the visitor's session.

content_impressionsMetric

The total number of times content blocks were displayed to users.

content_interaction_rateMetric

The rate at which users interacted with displayed content.

content_interactionsMetric

The total number of times users interacted with content blocks.

content_nameDimension

The title or name describing the tracked content block.

cookie_idDimension

The unique identifier stored in a user's cookie.

custom_event_actionDimension

The specific action performed within a custom event, such as "video-play".

custom_event_categoryDimension

The classification or grouping of a custom event, such as "video" or "form".

custom_event_nameDimension

The name or label associated with a specific custom event, providing more detail about the action.

custom_event_valueDimension

The numerical value assigned to a custom event, often used to quantify the impact or worth of an action, such as the number of items purchased or the total cost of an interaction.

custom_eventsMetric

The total number of custom events tracked.

device_brandDimension

The brand of the device used by the visitor.

device_modelDimension

The model of the device used by the visitor.

device_typeDimension

The type of device used by the visitor (e.g., 'desktop', 'mobile', 'tablet').

ecommerce_abandoned_cartsMetric

The count or value of shopping carts that were initiated with products but not converted into a completed purchase. This metric is calculated by Piwik PRO based on tracked cart interactions and sessions that end without an order.

ecommerce_conversionsMetric

Represents completed transactions or orders within your online store. This data is collected through specific ecommerce events and tags, providing insights into successful purchases and revenue generation.

end_dateDimension

The end date for the data retrieval period.

entriesMetric

Represents the number of visits that began on a specific page, indicating the entry point for user sessions on your website or app.

event_custom_dimension_{NUM}Dimension

An additional data attribute configured to collect specific details about events, such as page views or downloads. Each dimension is identified by a unique number and provides extra context beyond standard event parameters.

event_idDimension

The unique identifier for a specific event record in the database.

event_typeDimension

The classification of a user action on the website or app, such as a page view, custom event, goal conversion, download, or outlink.

event_urlDimension

The URL of the page where an event occurred.

eventsMetric

The total number of tracked actions or interactions.

exitsMetric

Represents the number of visits that concluded on a specific page, indicating where user sessions ended on your website or app.

goal_conversionsMetric

The total number of times defined goals were achieved.

goal_idDimension

The unique identifier of a specific goal.

goal_revenueMetric

The revenue associated with a specific goal completion. Piwik PRO can track total revenue and revenue per visit for each goal.

google_ads_campaign_idMetric

The unique identifier for a specific advertising campaign within Google Ads. This ID allows you to track and analyze the performance of individual Google Ads campaigns within Piwik PRO reports.

google_ads_campaign_nameDimension

Represents the name of the Google Ads campaign associated with the collected user behavior or conversion data within Piwik PRO reports. This data is downloaded from Google Ads as part of the integration.

keywordDimension

The search term used by a visitor to find the website.

location_country_nameDimension

The name of the country from which the user's activity originated.

location_latitudeDimension

The latitude coordinate of the user's geographical location.

location_longitudeDimension

The longitude coordinate of the user's geographical location.

mediumDimension

The general category of the source, such as 'organic', 'cpc', or 'referral'.

operating_systemDimension

The operating system used by the visitor (e.g., Windows, macOS, Android).

operating_system_versionMetric

The version of the operating system used by the visitor.

order_idDimension

The unique identifier for an e-commerce order.

page_viewsMetric

The total number of times pages were viewed.

referrer_typeDimension

The type of referrer that led a visitor to the website, such as 'direct', 'search_engine', or 'website'.

resolutionDimension

The screen resolution of the device used by the visitor (width x height).

resolution_heightDimension

The height of the screen resolution of the device used by the visitor.

resolution_widthDimension

The width of the screen resolution of the device used by the visitor.

returning_visitors_rateMetric

The percentage of visitors who have previously visited the website or application.

revenueMetric

The total monetary value generated from sales or goal conversions.

session_entry_urlDimension

The URL of the first page visited in a session.

session_exit_urlDimension

The URL of the last page visited in a session.

session_goalsDimension

A collection of goals achieved within a single user session.

session_idDimension

The unique identifier for a user's session.

session_total_ecommerce_conversionsMetric

The total number of e-commerce conversions recorded within a single user session.

session_total_eventsMetric

The total number of events that occurred within a single session.

session_total_goal_conversionsMetric

The total number of goal conversions achieved within a single session.

session_total_outlinksMetric

The total number of clicks on external links within a session.

session_total_page_viewsMetric

The total number of page views within a single session.

session_total_timeMetric

The total duration of a user's session on the website or app.

session_unique_outlinksMetric

The number of unique external links clicked within a session.

session_unique_page_viewsMetric

The number of unique pages viewed within a single session.

sessionsMetric

The total number of user sessions on the website or application.

sourceDimension

The origin of the website traffic, such as 'Google' or 'Facebook'.

source_mediumDimension

A combination of the traffic source and medium, providing a more detailed view of where users came from.

start_dateDimension

The start date for the data retrieval period.

time_on_pageMetric

The amount of time users spent viewing a specific page.

timestampDimension

The exact date and time when an event occurred.

unique_content_impressionsMetric

The number of unique times content blocks were displayed to users.

unique_page_viewsMetric

The number of unique pages viewed during visits.

user_idDimension

A persistent identifier for a user, allowing tracking across multiple sessions and devices.

usersMetric

The total number of unique users who visited a website or used an application within a specified period. This metric provides a count of distinct individuals.

visitor_days_since_first_sessionMetric

The number of days that have passed since the visitor's very first session.

visitor_days_since_last_sessionMetric

The number of days that have passed since the visitor's last session.

visitor_idDimension

The unique identifier assigned to a visitor.

visitor_returningDimension

Indicates whether a visitor is returning (e.g., '1' for returning, '0' for new).

visitor_session_numberMetric

The sequential number of the visitor's current session.

visitorsMetric

The total number of unique visitors to the website or application.

website_nameDimension

The name of the website or application where the analytics data was collected.