Piano Analytics: Most-used fields

The table below gives information about most-used fields that you can import from Piano Analytics. 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
date	date	The specific date when the event or data was recorded.	dimension
date_week	date_week	The week of the year when the event or data was recorded.	metric
event_name	event_name	The name of the event tracked on your website or application.	dimension
geo_country	geo_country	The country from which the user or visitor accessed the site.	dimension
m_events	m_events	The total number of events recorded.	metric
m_events_all	m_events_all	Represents the total count of all tracked user events on your digital properties, such as page views, clicks, or conversions.	metric
m_new_visitors	m_new_visitors	The number of unique visitors who are visiting the site for the first time.	metric
m_unique_visitors	m_unique_visitors	The number of distinct individuals who visited the site during the reporting period.	metric
m_visits	m_visits	The total number of visits to the site.	metric
page	page	Indicates the specific page or screen displayed to a visitor, essential for measuring traffic and analyzing content performance.	dimension
site	site	The label or name of the website or application related to the measured event.	dimension
site_id	site_id	The unique identifier for the website or application.	dimension
site_platform	site_platform	Refers to the platform type (e.g., web browser, native mobile app) from which an event or user interaction originates. (from previous search result)	dimension
src_audience	src_audience	Identifies the source or segment that an audience originated from, providing insights into audience acquisition. (from first browse result)	dimension
src_campaign	src_campaign	The name or identifier of the marketing campaign that drove the traffic.	dimension
src_campaign_ad	src_campaign_ad	Specifies the particular advertising campaign or ad that served as the source for a user interaction or event.	dimension
src_content	src_content	The specific content (e.g., banner, email title) that was clicked or engaged with.	dimension
src_creation	src_creation	Indicates the specific element or advertisement that led to a marketing campaign event.	dimension
src_format	src_format	Describes the format of the creative element or advertisement that initiated a marketing campaign event.	dimension
src_medium	src_medium	The category of the traffic source (e.g., ‘organic’, ‘cpc’, ‘referral’).	dimension
src_term	src_term	Indicates the search term or keyword used by a visitor that led them to the digital property.	dimension
status	status		dimension
transaction_status	transaction_status	Describes the current state or outcome of an e-commerce transaction, such as completed, pending, or failed. (from previous search result)	dimension
utm_campaign	utm_campaign	The value of the utm_campaign parameter, used to identify a specific campaign.	dimension
utm_content	utm_content	The value of the utm_content parameter, used to differentiate similar content within the same ad or link.	dimension