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 that were bounces, calculated as (Bounces / Entries) * 100%.	metric
bounce_rate_events	bounce_rate_events	The bounce rate calculated based on events, representing sessions where only one page was viewed without further interaction or goal conversion.	metric
bounces	bounces	The number of sessions where visitors viewed only one page and did not trigger any other interactions before leaving the website.	metric
browser_engine	browser_engine	The rendering engine used by the user’s browser (e.g., WebKit, Gecko).	dimension
browser_fingerprint	browser_fingerprint		metric
browser_language_iso639	browser_language_iso639	The language setting of the user’s browser, in ISO 639 format.	dimension
browser_name	browser_name	The name of the web browser used by the visitor (e.g., Chrome, Firefox).	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_gclid	campaign_gclid	The Google Click Identifier (GCLID) associated with a campaign, used for tracking Google Ads performance.	dimension
campaign_id	campaign_id	The unique identifier of a marketing campaign.	dimension
campaign_name	campaign_name	The name of the marketing campaign, typically used to track the effectiveness of different marketing efforts.	dimension
content_impressions	content_impressions	The number of times a piece of content was displayed to users.	metric
content_interaction_rate	content_interaction_rate		metric
content_interactions	content_interactions	The number of times users interacted with a piece of content.	metric
content_name	content_name	The title or name of the content being viewed or interacted with.	dimension
cookie_id	cookie_id	The unique identifier stored in a user’s cookie.	dimension
custom_event_action	custom_event_action	The specific action taken by a user within a custom event.	dimension
custom_event_category	custom_event_category	The category under which a custom event is grouped.	dimension
custom_event_name	custom_event_name	The name of a custom event, indicating a specific user interaction that is tracked beyond standard page views.	dimension
custom_event_value	custom_event_value	A numerical value associated with a custom event, often used to assign a quantitative measure to the event.	dimension
custom_events	custom_events	The total number of custom events recorded.	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
download_url	download_url	The URL of a file that was downloaded by a user.	dimension
downloads	downloads	The total number of file downloads.	metric
ecommerce_abandoned_carts	ecommerce_abandoned_carts	The number of shopping carts that were initiated but not completed with a purchase.	metric
ecommerce_conversion_rate	ecommerce_conversion_rate	The percentage of sessions that resulted in an e-commerce conversion or purchase.	metric
ecommerce_conversions	ecommerce_conversions	The total number of successful e-commerce transactions or purchases.	metric
end_date	end_date	The end date for the data retrieval period.	dimension
entries	entries	The number of times a visitor entered a website or a specific page.	metric
entry_rate	entry_rate	The percentage of sessions that started on a particular page.	metric
event_id	event_id	The unique identifier for a specific event.	dimension
event_title	event_title	The title of the page or element where an event occurred.	dimension
event_type	event_type	The classification of an event, such as ‘page_view’, ‘click’, or ‘download’.	dimension
event_url	event_url	The URL of the page where an event occurred.	dimension
events	events	The total number of individual interactions or actions recorded on the website or app.	metric
events_per_session	events_per_session	The average number of events that occurred per session.	metric
exit_rate	exit_rate	The percentage of page views that were the last in a session.	metric
exit_rate_events	exit_rate_events		metric
exits	exits	The number of times visitors exited a website or a specific page.	metric
goal_conversion_rate	goal_conversion_rate	The percentage of sessions that resulted in a goal conversion.	metric
goal_conversions	goal_conversions	The number of times a predefined goal was achieved by visitors.	metric
goal_id	goal_id	The unique identifier of a specific goal configured in Piwik PRO.	dimension
google_ads_campaign_id	google_ads_campaign_id	The unique identifier for a Google Ads campaign.	dimension
google_ads_customer_id	google_ads_customer_id	The unique identifier for a Google Ads customer account.	dimension
google_ads_customer_name	google_ads_customer_name	The name associated with a Google Ads customer account.	dimension
ipv4_address	ipv4_address		dimension
ipv6_address	ipv6_address		dimension
is_bounce	is_bounce	Indicates whether a session was a bounce (True/False).	metric
keyword	keyword	The search term used by a visitor to find the website.	dimension
local_hour	local_hour	The hour of the day in the user’s local timezone.	metric
location_city_name	location_city_name	The name of the city from which the user’s activity originated.	dimension
location_continent_iso_code	location_continent_iso_code	The ISO code of the continent from which the user’s activity originated.	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
location_metro_code	location_metro_code	The metro code (e.g., DMA region in the US) of the user’s location.	dimension
location_organization	location_organization	The organization or ISP associated with the user’s IP address.	dimension
location_provider	location_provider	The internet service provider (ISP) of the user’s connection.	dimension
location_subdivision_{NUM}_name	location_subdivision_{NUM}_name	The name of a geographical subdivision, such as a state or province, where the user’s activity originated.	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
order_id	order_id	The unique identifier for an e-commerce order.	dimension
outlink_url	outlink_url	The URL of an external link clicked by a user.	dimension
outlinks	outlinks	The total number of clicks on external links.	metric
page_views	page_views	The total number of times pages were viewed by users.	metric
plugin_cookie	plugin_cookie		metric
plugin_director	plugin_director		metric
plugin_flash	plugin_flash		metric
plugin_gears	plugin_gears		metric
plugin_java	plugin_java		metric
plugin_pdf	plugin_pdf		metric
plugin_quicktime	plugin_quicktime		metric
plugin_realplayer	plugin_realplayer		metric
plugin_silverlight	plugin_silverlight		metric
plugin_windowsmedia	plugin_windowsmedia		metric
referrer_type	referrer_type	The type of referrer that led a visitor to the website, such as ‘direct’, ‘search_engine’, or ‘website’.	dimension
referrer_url	referrer_url	The full URL of the page that referred the user to the current page.	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 total visitors who have visited the website before.	metric
revenue	revenue	The monetary value generated from e-commerce transactions.	metric
search_category	search_category	The category associated with a site search performed by a user.	dimension
search_keyword	search_keyword	The keyword entered by a user into the website’s internal search engine.	dimension
search_results_count	search_results_count	The number of results returned for a site search query.	dimension
searches	searches	The total number of internal site searches performed by users.	metric
session_ecommerce_status	session_ecommerce_status	The e-commerce status of a session, indicating whether a purchase was made or abandoned.	dimension
session_entry_title	session_entry_title	The title of the first page visited in a session.	dimension
session_entry_url	session_entry_url	The URL of the first page visited in a session.	dimension
session_exit_title	session_exit_title	The title of the last page visited in a session.	dimension
session_exit_url	session_exit_url	The URL of the last page visited in a session.	dimension
session_goals	session_goals	The number of goals achieved within a single session.	dimension
session_id	session_id	The unique identifier for a user’s session.	dimension
session_second_title	session_second_title	The title of the second page viewed in a user’s session.	dimension
session_second_url	session_second_url	The URL of the second page viewed in a user’s session.	dimension
session_total_abandoned_carts	session_total_abandoned_carts	The total number of abandoned carts within a single session.	metric
session_total_content_impressions	session_total_content_impressions	The total number of times content was displayed during a user’s session.	metric
session_total_content_interactions	session_total_content_interactions	The total number of interactions with content during a user’s session.	metric
session_total_custom_events	session_total_custom_events	The total number of custom events triggered within a single session.	metric
session_total_downloads	session_total_downloads	The total number of downloads initiated within a single session.	metric
session_total_ecommerce_conversions	session_total_ecommerce_conversions	The total number of e-commerce conversions within a single session.	metric
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 single session.	metric
session_total_page_views	session_total_page_views	The total number of page views within a single session.	metric
session_total_site_searches	session_total_site_searches	The total number of internal site searches performed 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_content_impressions	session_unique_content_impressions	The number of unique content impressions within a single session.	metric
session_unique_content_interactions	session_unique_content_interactions	The number of unique content interactions within a single session.	metric
session_unique_custom_events	session_unique_custom_events	The number of unique custom events triggered within a single session.	metric
session_unique_downloads	session_unique_downloads	The number of unique downloads initiated within a single session.	metric
session_unique_outlinks	session_unique_outlinks	The number of unique external links clicked within a single session.	metric
session_unique_page_views	session_unique_page_views	The number of unique pages viewed within a single session.	metric
session_unique_searches	session_unique_searches	The number of unique internal site searches performed within a single session.	metric
sessions	sessions	The total number of visits to the website or app.	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 visitors 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 a piece of content was displayed to users.	metric
unique_content_interactions	unique_content_interactions	The number of unique interactions with content.	metric
unique_custom_events	unique_custom_events	The number of unique custom events recorded.	metric
unique_downloads	unique_downloads	The number of unique files downloaded.	metric
unique_goal_conversions	unique_goal_conversions	The number of unique goal conversions achieved.	metric
unique_page_views	unique_page_views	The number of sessions during which a specific page was viewed at least once.	metric
unique_purchases	unique_purchases	The number of unique e-commerce purchases made.	metric
unique_searches	unique_searches	The number of unique internal site searches performed by users.	metric
user_id	user_id	A persistent identifier for a user, allowing tracking across multiple sessions and devices.	dimension
users	users	The total number of individual users who visited the website or app.	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_days_since_order	visitor_days_since_order	The number of days that have passed since the visitor’s last order.	dimension
visitor_id	visitor_id	The unique identifier assigned to a visitor.	dimension
visitor_ips	visitor_ips		metric
visitor_returning	visitor_returning	Indicates whether the visitor is a returning visitor (True/False).	dimension
visitor_session_number	visitor_session_number	The sequential number of the current session for a specific visitor.	metric
visitors	visitors	The number of unique individuals who visited the website or app.	metric
website_name	website_name	The name of the website or application where the analytics data was collected.	dimension