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.

API name	Adverity UI name	Description	Use in Adverity
bounce_rate	bounce_rate	The percentage of sessions where users viewed only one page and exited without further interaction.	metric
bounces	bounces	The total number of sessions that resulted in a bounce (single page view).	metric
browser_engine	browser_engine	The rendering engine used by the user’s browser (e.g., WebKit, Gecko).	dimension
browser_language_iso639	browser_language_iso639	The language setting of the user’s browser, in ISO 639 format.	dimension
browser_version	browser_version	The version of the web browser used by the visitor.	metric
campaign_content	campaign_content	The specific content or ad creative used in a marketing campaign.	dimension
campaign_id	campaign_id	The unique identifier of a marketing campaign.	dimension
campaign_name	campaign_name	The name of the campaign associated with the visitor’s session.	dimension
content_impressions	content_impressions	The total number of times content blocks were displayed to users.	metric
content_interaction_rate	content_interaction_rate	The rate at which users interacted with displayed content.	metric
content_interactions	content_interactions	The total number of times users interacted with content blocks.	metric
content_name	content_name	The title or name describing the tracked content block.	dimension
cookie_id	cookie_id	The unique identifier stored in a user’s cookie.	dimension
custom_event_action	custom_event_action	The specific action performed within a custom event, such as “video-play”.	dimension
custom_event_category	custom_event_category	The classification or grouping of a custom event, such as “video” or “form”.	dimension
custom_event_name	custom_event_name	The name or label associated with a specific custom event, providing more detail about the action.	dimension
custom_event_value	custom_event_value	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.	dimension
custom_events	custom_events	The total number of custom events tracked.	metric
device_brand	device_brand	The brand of the device used by the visitor.	dimension
device_model	device_model	The model of the device used by the visitor.	dimension
device_type	device_type	The type of device used by the visitor (e.g., ‘desktop’, ‘mobile’, ‘tablet’).	dimension
end_date	end_date	The end date for the data retrieval period.	dimension
entries	entries	Represents the number of visits that began on a specific page, indicating the entry point for user sessions on your website or app.	metric
event_custom_dimension_{NUM}	event_custom_dimension_{NUM}	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.	dimension
event_title	event_title	The title of the page where an event occurred.	dimension
event_url	event_url	The URL of the page where an event occurred.	dimension
events	events	The total number of tracked actions or interactions.	metric
exits	exits	Represents the number of visits that concluded on a specific page, indicating where user sessions ended on your website or app.	metric
goal_conversions	goal_conversions	The total number of times defined goals were achieved.	metric
goal_id	goal_id	The unique identifier of a specific goal.	dimension
keyword	keyword	The search term used by a visitor to find the website.	dimension
location_country_name	location_country_name	The name of the country from which the user’s activity originated.	dimension
location_latitude	location_latitude	The latitude coordinate of the user’s geographical location.	dimension
location_longitude	location_longitude	The longitude coordinate of the user’s geographical location.	dimension
medium	medium	The general category of the source, such as ‘organic’, ‘cpc’, or ‘referral’.	dimension
operating_system	operating_system	The operating system used by the visitor (e.g., Windows, macOS, Android).	dimension
operating_system_version	operating_system_version	The version of the operating system used by the visitor.	metric
page_views	page_views	The total number of times pages were viewed.	metric
referrer_type	referrer_type	The type of referrer that led a visitor to the website, such as ‘direct’, ‘search_engine’, or ‘website’.	dimension
resolution	resolution	The screen resolution of the device used by the visitor (width x height).	dimension
resolution_height	resolution_height	The height of the screen resolution of the device used by the visitor.	dimension
resolution_width	resolution_width	The width of the screen resolution of the device used by the visitor.	dimension
returning_visitors_rate	returning_visitors_rate	The percentage of visitors who have previously visited the website or application.	metric
revenue	revenue	The total monetary value generated from sales or goal conversions.	metric
session_entry_url	session_entry_url	The URL of the first page visited in a session.	dimension
session_exit_url	session_exit_url	The URL of the last page visited in a session.	dimension
session_id	session_id	The unique identifier for a user’s session.	dimension
session_total_events	session_total_events	The total number of events that occurred within a single session.	metric
session_total_goal_conversions	session_total_goal_conversions	The total number of goal conversions achieved within a single session.	metric
session_total_outlinks	session_total_outlinks	The total number of clicks on external links within a session.	metric
session_total_page_views	session_total_page_views	The total number of page views within a single session.	metric
session_total_time	session_total_time	The total duration of a user’s session on the website or app.	metric
session_unique_outlinks	session_unique_outlinks	The number of unique external links clicked within a session.	metric
session_unique_page_views	session_unique_page_views	The number of unique pages viewed within a single session.	metric
sessions	sessions	The total number of user sessions on the website or application.	metric
source	source	The origin of the website traffic, such as ‘Google’ or ‘Facebook’.	dimension
source_medium	source_medium	A combination of the traffic source and medium, providing a more detailed view of where users came from.	dimension
start_date	start_date	The start date for the data retrieval period.	dimension
time_on_page	time_on_page	The amount of time users spent viewing a specific page.	metric
timestamp	timestamp	The exact date and time when an event occurred.	dimension
unique_content_impressions	unique_content_impressions	The number of unique times content blocks were displayed to users.	metric
unique_page_views	unique_page_views	The number of unique pages viewed during visits.	metric
user_id	user_id	A persistent identifier for a user, allowing tracking across multiple sessions and devices.	dimension
users	users	Represents the number of unique visitors who have a User ID assigned to their visit. This metric is used to track cross-device behavior, stitch sessions across different IPs, and provide a more accurate analysis of user journeys, typically for logged-in users.	metric
visitor_days_since_first_session	visitor_days_since_first_session	The number of days that have passed since the visitor’s very first session.	metric
visitor_days_since_last_session	visitor_days_since_last_session	The number of days that have passed since the visitor’s last session.	metric
visitor_id	visitor_id	The unique identifier assigned to a visitor.	dimension
visitor_returning	visitor_returning	Indicates whether a visitor is returning (e.g., ‘1’ for returning, ‘0’ for new).	dimension
visitor_session_number	visitor_session_number	The sequential number of the visitor’s current session.	metric
visitors	visitors	The total number of unique visitors to the website or application.	metric
website_name	website_name	The name of the website or application where the analytics data was collected.	dimension