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.
CountrycountryDimension
The country targeted by the ad or where the ad was displayed, identified by its ISO 3166-1 alpha-2 code.
DevicedeviceDimension
The type of device on which the ad was served (e.g., DESKTOP, MOBILE, TABLET).
account_agency_idDimension
The unique identifier for the top-level agency entity that owns or manages the account.
account_currencyDimension
The currency used for the account's financial transactions and reporting (e.g., USD, EUR, GBP).
account_nameDimension
The name associated with the advertising account.
account_statusDimension
The current operational status of the account, such as active, suspended, or closed.
ad_creative_brand_namead_brand_nameDimension
The brand name associated with the ad creative.
ad_creative_descriptionad_descriptionDimension
A textual description of the ad creative content.
ad_creative_display_urlad_display_urlDimension
The URL displayed as part of the ad creative.
ad_creative_image_urlad_image_urlDimension
The URL pointing to the image asset used in the ad creative.
ad_group_daily_budgetMetric
The daily budget allocated for an ad group. This value is required when creating or updating an ad group.
ad_group_nameDimension
The name of the ad group within a campaign.
ad_group_statusDimension
The current operational status of the ad group, indicating whether it is active, paused, or has other states.
ad_labelDimension
A free-form text label associated with the ad for categorization or tracking purposes.
ad_titleDimension
The title of the creative used in the ad.
ad_urlDimension
The landing URL where users are directed after clicking the ad.
avg_cost_per_non_bounced_visitMetric
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_pageviewMetric
The average cost incurred for each pageview on a website.
avg_cost_per_visitMetric
The average cost incurred for each visit to a website.
avg_cpcMetric
The average cost which you pay to the publishers for each click on your ad.
avg_cpcvMetric
The average cost incurred for each completed view of your advertisement. This is a common metric for video advertising.
avg_cpmMetric
The average cost which you pay per one thousand impressions on your advertising medium.
avg_cpvMetric
The average cost which you pay for every view your advertisement gets.
avg_vcpmMetric
Average cost per thousand viewable impressions, reflecting the cost efficiency of reaching a thousand viewable impressions.
bounced_rateMetric
The percentage of total visits that were identified as bounced visits.
bounced_visitsMetric
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_nameDimension
The name of the advertising campaign.
campaign_statusDimension
The current operational status of the campaign, indicating whether it is active, paused, or completed.
clicksMetric
The total number of clicks received by the ad or campaign. This is a core campaign performance metric.
content_ad_statusDimension
The current operational status of the content ad, such as active, paused, or pending review.
ctrMetric
The Click-Through Rate, which measures how often users who see your advertisement end up clicking on it.
data_costMetric
The cost incurred for utilizing data segments or third-party data in advertising campaigns.
impression_distribution_not_measurableMetric
Represents the percentage or distribution of ad impressions for which viewability could not be measured. This metric is typically available in asynchronous reports.
impression_distribution_not_viewableMetric
The breakdown or share of impressions that were measured but determined not to meet the viewability criteria.
impression_distribution_viewableMetric
The breakdown or share of impressions that were measured and met the viewability criteria, confirming they were seen.
impressionsMetric
The total number of times an ad was shown. This is a core campaign performance metric.
license_feeMetric
Fees associated with platform usage, content licensing, or other service agreements.
marginMetric
The percentage fraction representing the margin applied to media or other costs.
measurable_impressionsMetric
The total number of impressions that were technically able to be measured for viewability.
media_source_statusDimension
The current operational status of the media source providing the ad inventory.
media_spendMetric
The total amount of money spent on media for the ad or campaign. This is a core campaign performance metric.
new_usersMetric
The number of unique users who visited a website for the first time within a given reporting period.
non_bounced_visitsMetric
The number of visits to a website that did not result in a bounce, indicating more engaged user sessions.
not_measurable_impressionsMetric
The total number of impressions that were unable to be measured for viewability, often due to technical limitations.
not_viewable_impressionsMetric
The total number of impressions that were determined not to be viewable according to industry standards.
pageviewsMetric
The total number of pages viewed as a result of ad interactions.
pageviews_per_visitMetric
The average number of pages viewed during a single visit to a website.
percentage_measurable_impressionsMetric
The proportion of total impressions that were technically capable of being measured for viewability, expressed as a percentage.
percentage_new_usersMetric
The proportion of new users relative to the total number of users who visited the site.
percentage_viewable_impressionsMetric
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_statusDimension
The current operational status of the publisher within the platform.
returning_usersMetric
The number of unique users who have previously visited the website and returned within the reporting period.
time_on_siteMetric
The average duration a user spent on the website during a single visit.
total_secondsMetric
The total time, measured in seconds, that users spent interacting with content. This metric is related to "Time on Site".
total_spendMetric
The total amount of money spent on the ad or campaign, including media, data, and license fees.
unique_usersMetric
The total number of distinct individuals who engaged with advertisements or visited the website within a given timeframe.
video_completeMetric
The number of times a video advertisement played to 100% completion.
video_first_quartileMetric
The number of times a video advertisement played to at least 25% of its total duration.
video_midpointMetric
The number of times a video advertisement played to at least 50% (midpoint) of its total duration.
video_progress_3sMetric
The count of video plays where the video content was consumed for at least 3 seconds, indicating initial engagement.
video_startMetric
The number of times a video advertisement began to play.
video_third_quartileMetric
The number of times a video advertisement played to at least 75% of its total duration.
viewable_impressionsMetric
The total number of impressions that were determined to be viewable according to established industry standards.
visitsMetric
The total number of user visits to the advertised landing page or site.
yesterday_spendMetric
The total amount of money spent on advertising campaigns during the previous day.