Zemanta: Most-used fields

The table below gives information about most-used fields that you can import from Zemanta. 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
Country	country	The country targeted by the ad or where the ad was displayed, identified by its ISO 3166-1 alpha-2 code.	dimension
Device	device	The type of device on which the ad was served (e.g., DESKTOP, MOBILE, TABLET).	dimension
Placement	placement	A dimension that specifies where the advertisement was shown, such as a particular website, app, or section within a media source.	dimension
account_agency_id	account_agency_id	The unique identifier for the top-level agency entity that owns or manages the account.	dimension
account_currency	account_currency	The currency used for the account’s financial transactions and reporting (e.g., USD, EUR, GBP).	dimension
account_name	account_name	The name associated with the advertising account.	dimension
account_status	account_status	The current operational status of the account, such as active, suspended, or closed.	dimension
ad_creative_brand_name	ad_brand_name	The brand name associated with the ad creative.	dimension
ad_creative_description	ad_description	A textual description of the ad creative content.	dimension
ad_creative_display_url	ad_display_url	The URL displayed as part of the ad creative.	dimension
ad_creative_image_url	ad_image_url	The URL pointing to the image asset used in the ad creative.	dimension
ad_group_daily_budget	ad_group_daily_budget	The daily budget allocated for an ad group. This value is required when creating or updating an ad group.	metric
ad_group_name	ad_group_name	The name of the ad group within a campaign.	dimension
ad_group_status	ad_group_status	The current operational status of the ad group, indicating whether it is active, paused, or has other states.	dimension
ad_group_targeting_placements	ad_group_targeting_placements	The specific locations or contexts where ads within an ad group are targeted to be displayed.	dimension
ad_label	ad_label	A free-form text label associated with the ad for categorization or tracking purposes.	dimension
ad_title	ad_title	The title of the creative used in the ad.	dimension
ad_url	ad_url	The landing URL where users are directed after clicking the ad.	dimension
avg_cost_per_non_bounced_visit	avg_cost_per_non_bounced_visit	The average cost incurred for each visit to a website that did not result in a bounce (e.g., a single page visit or very short duration).	metric
avg_cost_per_pageview	avg_cost_per_pageview	The average cost incurred for each pageview on a website.	metric
avg_cost_per_visit	avg_cost_per_visit	The average cost incurred for each visit to a website.	metric
avg_cpc	avg_cpc	The average cost which you pay to the publishers for each click on your ad.	metric
avg_cpcv	avg_cpcv	The average cost incurred for each completed view of your advertisement. This is a common metric for video advertising.	metric
avg_cpm	avg_cpm	The average cost which you pay per one thousand impressions on your advertising medium.	metric
avg_cpv	avg_cpv	The average cost which you pay for every view your advertisement gets.	metric
avg_vcpm	avg_vcpm	Average cost per thousand viewable impressions, reflecting the cost efficiency of reaching a thousand viewable impressions.	metric
bounced_rate	bounced_rate	The percentage of total visits that were identified as bounced visits.	metric
bounced_visits	bounced_visits	The number of visits to a landing page or website that resulted in a bounce (e.g., a single-page session or short duration visit).	metric
campaign_name	campaign_name	The name of the advertising campaign.	dimension
campaign_status	campaign_status	The current operational status of the campaign, indicating whether it is active, paused, or completed.	dimension
campaign_targeting_placements	campaign_targeting_placements	The specific locations or contexts where ads within a campaign are targeted to be displayed.	dimension
clicks	clicks	The total number of clicks received by the ad or campaign. This is a core campaign performance metric.	metric
content_ad_status	content_ad_status	The current operational status of the content ad, such as active, paused, or pending review.	dimension
ctr	ctr	The Click-Through Rate, which measures how often users who see your advertisement end up clicking on it.	metric
data_cost	data_cost	The cost incurred for utilizing data segments or third-party data in advertising campaigns.	metric
impression_distribution_not_measurable	impression_distribution_not_measurable	Represents the distribution of impressions that could not be measured for viewability.	metric
impression_distribution_not_viewable	impression_distribution_not_viewable	The breakdown or share of impressions that were measured but determined not to meet the viewability criteria.	metric
impression_distribution_viewable	impression_distribution_viewable	The breakdown or share of impressions that were measured and met the viewability criteria, confirming they were seen.	metric
impressions	impressions	The total number of times an ad was shown. This is a core campaign performance metric.	metric
license_fee	license_fee	Fees associated with platform usage, content licensing, or other service agreements.	metric
margin	margin	The percentage fraction representing the margin applied to media or other costs.	metric
measurable_impressions	measurable_impressions	The total number of impressions that were technically able to be measured for viewability.	metric
media_source_status	media_source_status	The current operational status of the media source providing the ad inventory.	dimension
media_spend	media_spend	The total amount of money spent on media for the ad or campaign. This is a core campaign performance metric.	metric
new_users	new_users	The number of unique users who visited a website for the first time within a given reporting period.	metric
non_bounced_visits	non_bounced_visits	The number of visits to a website that did not result in a bounce, indicating more engaged user sessions.	metric
not_measurable_impressions	not_measurable_impressions	The total number of impressions that were unable to be measured for viewability, often due to technical limitations.	metric
not_viewable_impressions	not_viewable_impressions	The total number of impressions that were determined not to be viewable according to industry standards.	metric
pageviews	pageviews	The total number of pages viewed as a result of ad interactions.	metric
pageviews_per_visit	pageviews_per_visit	The average number of pages viewed during a single visit to a website.	metric
percentage_measurable_impressions	percentage_measurable_impressions	The proportion of total impressions that were technically capable of being measured for viewability, expressed as a percentage.	metric
percentage_new_users	percentage_new_users	The proportion of new users relative to the total number of users who visited the site.	metric
percentage_viewable_impressions	percentage_viewable_impressions	The percentage of impressions that were deemed viewable according to industry standards, reflecting the proportion of ads that had an opportunity to be seen by users.	metric
publisher_status	publisher_status	The current operational status of the publisher within the platform.	dimension
returning_users	returning_users	The number of unique users who have previously visited the website and returned within the reporting period.	metric
time_on_site	time_on_site	The average duration a user spent on the website during a single visit.	metric
total_seconds	total_seconds	The total time, measured in seconds, that users spent interacting with content. This metric is related to “Time on Site”.	metric
total_spend	total_spend	The total amount of money spent on the ad or campaign, including media, data, and license fees.	metric
unique_users	unique_users	The total number of distinct individuals who engaged with advertisements or visited the website within a given timeframe.	metric
video_complete	video_complete	The number of times a video advertisement played to 100% completion.	metric
video_first_quartile	video_first_quartile	The number of times a video advertisement played to at least 25% of its total duration.	metric
video_midpoint	video_midpoint	The number of times a video advertisement played to at least 50% (midpoint) of its total duration.	metric
video_progress_3s	video_progress_3s	The count of video plays where the video content was consumed for at least 3 seconds, indicating initial engagement.	metric
video_start	video_start	The number of times a video advertisement began to play.	metric
video_third_quartile	video_third_quartile	The number of times a video advertisement played to at least 75% of its total duration.	metric
viewable_impressions	viewable_impressions	The total number of impressions that were determined to be viewable according to established industry standards.	metric
visits	visits	The total number of user visits to the advertised landing page or site.	metric
yesterday_spend	yesterday_spend	The total amount of money spent on advertising campaigns during the previous day.	metric