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