Adform (Buyer): Most-used fields
The table below gives information about most-used fields that you can import from Adform (Buyer). 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.
DateConvertedMetric
The date on which a conversion event associated with a campaign or ad interaction was recorded.
Tracking SegmentDimension
A segment of a Data Management Platform (DMP) audience that was used in ad delivery or targeting.
WeekAsDateDimension
The date representing the start of the week.
WeekNumMetric
The week number within the year.
YearDimension
The year in which the ad event occurred.
activeDimension
Indicates whether a campaign or line item is currently active. This field can be used for filtering reports.
adCreativeTypeDimension
The classification of the ad creative, e.g., display, video, native.
adServing.levelDimension
Indicates the specific level of granularity for reporting or configuring ad serving, such as campaign, line item, or banner level.
adServing.methodDimension
Describes the method used for ad delivery, distinguishing between different approaches like Real-Time Bidding (RTB) or direct deals.
adform_video_startMetric
The total number of video starts, including both auto-play and user-initiated video plays. Only unique starts are reported.
adform_vtr_100Metric
Represents the percentage of a video ad that was played to 100% completion. This is a metric indicating full video view-through.
adform_vtr_25Metric
Represents the percentage of a video ad that was played to at least 25% completion. This is a metric indicating partial video view-through.
adform_vtr_50Metric
Represents the percentage of a video ad that was played to at least 50% completion. This is a metric indicating partial video view-through.
adform_vtr_75Metric
Represents the percentage of a video ad that was played to at least 75% completion. This is a metric indicating partial video view-through.
advertiserIdDimension
A unique identifier for the advertiser account.
advertiserNameDimension
The name of the advertiser.
agencyIdMetric
The unique identifier for the agency associated with the campaign or advertiser.
avgFrequencyMetric
The average number of times a unique user was shown an ad.
avgFrequencycrossdeviceMetric
The average number of times an ad is delivered to the same user across different devices within a defined time frame. This metric helps understand user exposure across their various devices.
avgViewabilityTimeMetric
The average time an ad was viewable on screen.
bannerDimension
The name or identifier of the creative banner used in the ad campaign.
bannerAttribute1Dimension
A custom label assigned to banners for reporting data in different splits.
bannerAttribute1IDMetric
The identifier for the first custom attribute associated with a banner, allowing for custom grouping or filtering of banner data.
bannerAttribute2Dimension
Groups information by Banner Attribute 2, which is a user-defined property of a banner.
bannerAttribute3Dimension
Groups information by Banner Attribute 3, which is a user-defined property of a banner.
bannerFormatDimension
The format or layout specification of the ad banner, such as size or type.
bannerFormatIDDimension
Unique identifier for the format of the banner ad.
bannerGlobalIDDimension
A global unique identifier for the banner ad.
bannerIDDimension
A unique identifier for the ad banner.
bannerSizeDimension
The dimensions (e.g., width x height) of the ad banner.
bannerTypeDimension
The specific type of the ad banner creative.
bannerWeightDimension
The weighting assigned to a banner for ad serving rotation, influencing its frequency of display.
bookedMetric
Indicates whether the item (e.g., impressions, clicks) was booked or reserved.
bookedClicksMetric
The number of clicks that were booked or reserved for a campaign.
bookedImpressionsMetric
The number of impressions that were booked or reserved for a campaign.
bookedTimeMetric
The amount of time booked for a campaign or ad placement.
browserDimension
The web browser used by the user when viewing the ad.
budgetMetric
The allocated financial budget for a campaign, defining the total spend limit.
buyTypeDimension
The method of purchasing ad inventory, such as programmatic or direct.
campaignDimension
The name or identifier of the advertising campaign.
campaignBillingIDDimension
A unique identifier for a campaign, primarily used for financial tracking and billing purposes.
campaignBudgetMetric
The total allocated budget for a specific campaign, as defined within the Adform platform.
campaignBudgetSpendDimension
Represents the actual amount of money spent against a campaign's budget.
campaignCurrencyDimension
The currency in which the campaign budget and costs are reported.
campaignEndDateDimension
The scheduled end date of the campaign.
campaignIDDimension
A unique identifier for the advertising campaign.
campaignIdDimension
A unique identifier for an advertising campaign.
campaignManagerIdMetric
An identifier that references the manager or entity responsible for the specific campaign.
campaignPurchaseOrderNumberDimension
The purchase order number associated with a campaign, used for internal or external procurement and financial reconciliation.
campaignStartDateDimension
The date on which the advertising campaign is scheduled to begin.
campaignStatusDimension
The current status of the campaign (e.g., active, paused, completed).
campaignSubTypeDimension
The specific type of a campaign, such as Google, Microsoft, display, search (non-API), social media, real-time bidding (RTB), affiliate, or email.
campaignTimeZoneDimension
The geographical timezone setting for the campaign, which impacts scheduling of ad delivery and the reporting of time-based metrics.
campaignTypeDimension
The classification or category of the advertising campaign (e.g., brand awareness, direct response).
channelsDimension
The marketing or media channels through which an ad campaign is delivered, such as Display, Affiliate, Email, or Social Media.
cityDimension
The city of the user's location.
clicksMetric
The total number of clicks on an ad.
clicks (adUniqueness=campaignDayUnique)Metric
The number of unique clicks within a campaign per day, counting each user's click once per campaign per day.
clicks (adUniqueness=campaignUnique)Metric
The number of unique clicks within a campaign, counting each user's click once per campaign.
clicks (adUniqueness=lineItemDayUnique)Metric
The number of clicks recorded, with 'lineItemDayUnique' indicating that clicks are counted uniquely per line item per day.
clicks (adUniqueness=lineItemUnique)Metric
The number of unique clicks within a line item, counting each user's click once per line item.
clicks (adUniqueness=mediaUnique)Metric
The number of unique clicks on a media asset, counting each user's click once per media.
clicksFirstPartyMetric
The number of first-party clicks for the selected dimension, with data limited to specific vendors and publishers.
clickscrossdeviceMetric
The total number of clicks attributed across multiple devices.
clientDimension
The name of the client or advertiser associated with the campaign.
clientIDDimension
A unique identifier for the client or advertiser.
clientIdMetric
A unique identifier for a client or advertiser account.
continentDimension
The continent of the user's location.
conversionsMetric
The total number of conversions recorded.
conversions (adInteraction=all)Metric
The total number of conversions attributed to all ad interactions.
conversions (adInteraction=postClick)Metric
The number of conversions attributed to a user clicking on an ad.
conversions (adInteraction=postImpression)Metric
The number of conversions attributed to a user viewing an ad impression without clicking.
conversions (conversionType=conversionType1)Metric
The count of user actions, such as purchases or sign-ups, attributed to a specific conversion type.
conversions (conversionType=conversionType2)Metric
The count of user actions, such as purchases or sign-ups, attributed to a specific conversion type.
conversions (conversionType=conversionType3)Metric
The number of conversions for a specific conversion type, Conversion Type 3.
conversions (pageCategory=download)Metric
The number of conversions where the conversion event was a download.
conversions (pageCategory=infoPages)Metric
The number of conversions where the conversion event occurred on an information page.
conversions (pageCategory=productPage)Metric
The number of conversions where the conversion event occurred on a product page.
conversions (pageCategory=signUpPages)Metric
The number of conversions where the conversion event occurred on a sign-up page.
conversions (pageCategory=thankYouPage)Metric
The number of conversions where the conversion event occurred on a thank you page.
conversionsAllMetric
The total number of all recorded conversions, regardless of type or category.
conversionsAll (adInteraction=postClick)Metric
The total number of conversions attributed to post-click ad interactions.
conversionsAll (conversionType=conversionType1)Metric
The total number of conversions from a tracked website for a specific conversion type, including all conversions from relevant tracking points.
conversionsAll (conversionType=conversionType2)Metric
All conversions of a specific type (conversionType2), representing desired actions taken by users.
conversionsAll (conversionType=conversionType3)Metric
All conversions of a specific type (conversionType3), representing desired actions taken by users.
conversionsAll (pageCategory=thankYouPage)Metric
The total number of conversions attributed to a 'thank you page' category.
conversionsSpecsMetric
The number of all Conversion pageviews displayed as a sum for all tracked conversion pages, with the possibility to change uniqueness settings for this metric.
conversionsSpecs (pageCategory=thankYouPage)Metric
The number of conversions where the page category is a 'Thank You Page'.
conversionscrossdeviceMetric
The total number of conversions attributed across multiple devices.
conversionscrossdevice (adInteraction=all)Metric
The total number of cross-device conversions, where 'adInteraction=all' indicates that all types of ad interactions are considered for attribution.
conversionscrossdevice (conversionType=conversionType1)Metric
The number of cross-device conversions for Conversion Type 1.
conversionscrossdevice (conversionType=conversionType2)Metric
The number of cross-device conversions for Conversion Type 2.
conversionscrossdevice (pageCategory=download)Metric
The number of cross-device conversions where the conversion event was a download.
conversionscrossdevice (pageCategory=infoPages)Metric
The number of cross-device conversions where the conversion event occurred on an information page.
conversionscrossdevice (pageCategory=productPage)Metric
The number of cross-device conversions where the conversion event occurred on a product page.
conversionscrossdevice (pageCategory=signUpPages)Metric
The number of cross-device conversions where the conversion event occurred on a sign-up page.
conversionscrossdevice (pageCategory=thankYouPage)Metric
The number of cross-device conversions where the conversion event occurred on a thank you page.
cookieLifeTime.clickHoursMetric
The duration, in hours, for which a cookie remains active after a user click for attribution purposes.
cookieLifeTime.recentClickSecondsMetric
The duration, in seconds, considered for a recent click in cookie-based attribution models.
cookieLifeTime.recentViewSecondsMetric
The duration, in seconds, considered for a recent view (impression) in cookie-based attribution models.
cookieLifeTime.viewHoursMetric
The duration, in hours, for which a cookie remains active after a user view (impression) for attribution purposes.
cookiesEnabledDimension
Technical dimension that groups information by a visitor's cookie acceptance setting (e.g., 'Enabled', 'Disabled', 'Opt out').
costMetric
The total cost associated with the ad campaign or specific ad activity.
cost (costType=fixedCost)Metric
The fixed cost incurred for the specified metric.
cost (costType=maxCost)Metric
The maximum possible cost incurred for the specified metric.
cost (costType=rtb)Metric
The cost incurred from Real-Time Bidding (RTB) activities.
cost_usdMetric
The cost incurred, expressed in US Dollars.
countryDimension
The country from which the ad interactions originated.
createdAttrackingCreatedAtDimension
The timestamp indicating when an entity or record was created.
ctrMetric
The Click-Through Rate, calculated as clicks divided by impressions, indicating the effectiveness of an ad.
currencyDimension
The currency code used for budget, cost, and other financial metrics within a campaign.
currency_codeDimension
The currency code used for financial transactions.
dateDimension
The date for which the data is reported.
dateIDDimension
A unique identifier representing the specific date for which reporting data is aggregated.
date_updatedDimension
Represents the date when a record, such as a statistic or metadata entry, was last modified or updated in the Adform platform. This field is commonly used to track data freshness or for filtering data within a specific time frame.
dayMonthMetric
A dimension representing the specific day and month for which the data is reported.
dayofweekDimension
The day of the week when the ad event occurred (e.g., Monday, Tuesday).
dealDimension
The name or identifier of a programmatic deal used to purchase ad inventory.
dealIDDimension
A unique identifier for a programmatic deal.
dealIdDimension
A unique identifier assigned by Adform to a specific advertising deal.
deliveredClicksMetric
The total number of clicks that were successfully registered or delivered.
deliveredImpressionsMetric
The total number of ad impressions that were delivered to users.
deviceModelDimension
The specific model of the device used by the user.
deviceTypeDimension
The type of device (e.g., desktop, mobile, tablet) on which the ad was displayed.
deviceVendorDimension
The vendor or manufacturer of the device used by the user.
dmpDspSegmentDimension
Groups data by DMP (Data Management Platform) audiences that were used (included or excluded) in Real-Time Bidding (RTB) to win an impression.
dmpRotatorsSegmentDimension
Groups data by DMP (Data Management Platform) Data Provider Segments that were used in creatives to show an impression.
dspAdTypesDimension
Specifies the types or formats of advertisements handled by the Demand-Side Platform (DSP), such as display, video, or native ads.
dynamicAdVersionDimension
This dimension groups data by Dynamic Ad Version, representing a single set of data variables and values used for messaging.
ecpc (costType=maxCost)Metric
The effective cost-per-click, calculated based on the maximum cost type for advertising, indicating the cost for each user click.
eligibleImpressionsMetric
The total number of impressions that were eligible to be displayed.
endDateDimension
The end date of a campaign or other time-bound entity, following ISO-8601 format.
engagementsMetric
The total number of user interactions or engagements with an ad.
engagingImpressionsMetric
Impressions that resulted in user engagement beyond just being viewable.
environmentsDimension
The digital platforms or contexts where ads are served, such as websites, mobile applications, or connected TV.
eventDimension
A specific user interaction or action tracked within a banner or ad.
eventsMetric
The total count of all tracked events or user interactions.
events (eventType=videoPlayStart)Metric
The number of times a video ad started playing.
frequencyCampaignDimension
The average number of times a unique user was exposed to a campaign's ads.
idDimension
A unique identifier for an entity.
impressionsMetric
The total number of times an ad was displayed.
impressions (adUniqueness=campaignDayUnique)Metric
The number of unique impressions within a campaign per day, counting each user's impression once per campaign per day.
impressions (adUniqueness=campaignUnique)Metric
The number of unique impressions within a campaign, counting each user's impression once per campaign.
impressions (adUniqueness=lineItemUnique)Metric
The number of unique impressions within a line item, counting each user's impression once per line item.
impressions (adUniqueness=mediaUnique)Metric
The number of unique impressions for a media asset, counting each user's impression once per media.
impressions (dataSource=adform)Metric
The total number of times an ad was displayed, specifically reported from the Adform data source.
impressionsFirstPartyMetric
The number of times a visitor with a first-party ID sees an ad on a publisher's site.
impressionscrossdeviceMetric
Impressions delivered to users across multiple devices.
impressionspctMetric
The share of impressions for the selected dimension in relation to the total number of impressions.
industryVerticalDimension
The industry sector or vertical associated with the advertiser or campaign.
inventorySourceIdMetric
A unique identifier for the specific source of ad inventory where ads can be displayed.
languageBrowserDimension
The language setting of the user's web browser.
lineItemDimension
The name of the line item within a campaign.
lineItemAdGapIDDimension
An AdGap ID used to facilitate comparison between Advertiser and Publisher reports by providing a unique identifier per line item.
lineItemEndDateDimension
The scheduled end date of the line item.
lineItemIDDimension
A unique identifier for the line item.
lineItemStartDateDimension
The scheduled start date of the line item.
managerIdMetric
The unique identifier for the manager responsible for the campaign or account.
measurableImpressionsMetric
The total number of impressions that were eligible for viewability measurement.
measurableImpressions (adUniqueness=campaignUnique)Metric
The number of measurable impressions within a campaign, indicating impressions that met certain measurement criteria, counting each user once per campaign.
measurableImpressions (adUniqueness=mediaUnique)Metric
The number of measurable impressions for a media asset, indicating impressions that met certain measurement criteria, counting each user once per media.
mediaDimension
The specific media placement or ad slot where the ad was displayed.
mediaIDDimension
A unique identifier for the media placement where the ad was displayed.
monthDimension
The month component of the date for which the data is reported.
monthIDMetric
The unique identifier for the month in which the ad was served.
mouseoversMetric
The number of times a user's mouse pointer hovered over an ad.
mpAmountMetric
The monetary amount related to media spend or revenue.
mpAmount (mpAmountType=gross)Metric
The gross monetary amount, including all fees and taxes.
mpAmount (mpAmountType=net)Metric
The net monetary amount, excluding certain fees or taxes.
mpAmount (mpAmountType=net2)Metric
The second net monetary amount type, used for specific financial calculations.
mpAmount (mpCalculationTime=total)Metric
The total monetary amount for the selected period, calculated across all transactions.
mpPrice (mpPriceType=gross)Metric
The gross price of media, including all fees and taxes.
mpPrice (mpPriceType=net)Metric
The net price of media, excluding certain fees or taxes.
mpPrice (mpPriceType=net2)Metric
The second net price type of media, used for specific cost calculations.
nameDimension
The name of an entity.
networkDimension
The advertising network or publisher network where the ads were served.
networkIDDimension
Groups data by the Adform Network ID.
newVisitsPercentMetric
The percentage of new visits to the website or landing page.
nonViewableImpressionsIABMetric
The number of impressions that were not deemed viewable according to IAB standards.
operatingSystemDimension
The operating system of the device used by the user.
orderDimension
The name or identifier of an order, which is a grouping level for managing line items within a campaign.
orderIDDimension
A unique identifier for an order.
pageDimension
The specific web page on which an ad was displayed or a tracked event occurred.
pageIDDimension
The unique identifier for a specific page, commonly used as a dimension to group metrics and analyze performance by page.
pageviewsMetric
The total number of times a page was viewed.
pageviewsAllMetric
The total number of pageviews across all tracked pages.
pageviewsAll (adInteraction=postClick)Metric
The total number of pageviews that occurred after an ad click.
pageviewsAll (adInteraction=postImpression)Metric
The total number of pageviews that occurred after an ad impression.
pageviewscrossdevice (visitUniqueness=allSitesCampaign)Metric
The number of times pages were viewed by unique visitors, distinguished using ID Fusion across different devices, domains, and browsers for all campaign sites.
placementViewTypeDimension
The booking or buy type of the selected ad placement, such as Impressions (CPM), Clicks (CPC), Viewable Impressions (vCPM), or Conversions.
priceMetric
The monetary cost associated with an ad impression, click, or conversion. This can vary based on the calculation method, such as net, gross, fixed, or RTB pricing.
regionDimension
The geographic region of the user's location.
renderedImpressionsMetric
The number of impressions that were fully loaded and displayed in the user's browser.
renderedImpressions (adUniqueness=campaignUnique)Metric
The number of unique impressions where the ad creative was fully rendered within a campaign, counting each user once per campaign.
renderedImpressions (adUniqueness=mediaUnique)Metric
The number of unique impressions where the ad creative was fully rendered for a media asset, counting each user once per media.
rtbAdformIncludedFeeMetric
Fees included by Adform in Real-Time Bidding (RTB) transactions.
rtbCrossDeviceCostMetric
The cost associated with cross-device targeting in Real-Time Bidding (RTB).
rtbInventorySourceDimension
The source of the ad inventory acquired through Real-Time Bidding.
rtbMediaCostMetric
The cost of media purchased through Real-Time Bidding.
rtbRichMediaFeeMetric
Fees associated with serving rich media ads in Real-Time Bidding (RTB) transactions.
salesMetric
The total revenue or value generated from conversions.
sales (conversionType=allConversionTypes)Metric
The total number of sales conversions, aggregating all conversion types, as tracked and reported by Adform.
sales (conversionType=conversionType1)Metric
The number of sales conversions categorized under 'conversionType1', as defined in the Adform platform.
sales (conversionType=conversionType2)Metric
The number of sales conversions categorized under 'conversionType2', as defined in the Adform platform.
seAccountDimension
Groups information by Search Engine account.
sourceDimension
The name of the connector or platform where the data originated.
startDateDimension
The start date of a campaign or other time-bound entity, following ISO-8601 format.
statusDimension
The current operational status of an entity, such as active or paused.
subTypeDimension
A more specific classification or category for a campaign or line item.
tagDimension
The name or description of the ad tag.
tagIDDimension
Unique identifier for the ad tag.
tagUIDDimension
A unique identifier for a tag, used for matching Adform's statistics to Media's data.
timeZoneDimension
The time zone setting for a campaign, used for scheduling and reporting data.
tracking.conversionAttributionPriorityDimension
The priority assigned to different tracking methods for attributing conversions.
tracking.enabledDimension
Indicates whether tracking is enabled for a specific entity or feature.
tracking.viewThroughEnabledDimension
Indicates whether view-through conversions are enabled for tracking, attributing conversions to ad impressions.
trackingDomainDimension
The domain used for tracking ad interactions and conversions.
trackingEnabledDimension
A flag indicating if tracking is enabled for user interactions.
trackingSetupIdMetric
A unique identifier for a specific tracking setup.
traffickingDimension
The process of setting up, scheduling, and managing ad campaigns and creative assets within an ad server for delivery.
typeDimension
The category or classification type of an entity.
undeterminedImpressionsMetric
The number of served impressions that were not measured for viewability.
uniqueClicksPercentMetric
The percentage of total clicks that represent unique users clicking on an advertisement.
uniqueImpressionsPercentMetric
The percentage of unique tracked ads (formerly known as impressions) in relation to all registered tracked ads.
uniqueReachMetric
The number of unique users who were exposed to the ad or campaign.
uniqueReach (reachUniqueness=campaignUnique)Metric
A metric representing the unique number of users reached within a specific campaign, ensuring that each user is counted only once per campaign.
uniqueReachPercentMetric
The percentage of unique users who were reached by the advertising campaign.
updatedAttrackingUpdatedAtDimension
The timestamp indicating when an entity or record was last updated.
updatedAtDateDimension
The date when the record or associated entity was last updated.
userInitiatedVideoPlayCountMetric
The number of times a video advertisement was played as a direct result of user interaction.
verifiedImpressionsMetric
Impressions that have been verified against specific quality criteria, such as viewability standards.
videoCompleteCountMetric
The total number of times a video ad played to 100% completion.
videoEventsMetric
The total number of events related to video ad playback.
videoEventsPlayTimePercentMetric
The percentage of the video ad that was played by users.
videoEventsPlayTimePercent (videoEventType=100Percent)Metric
The number of video plays that reached 100% completion.
videoEventsPlayTimePercent (videoEventType=25Percent)Metric
The number of video plays that reached 25% completion.
videoEventsPlayTimePercent (videoEventType=50Percent)Metric
The number of video plays that reached 50% completion.
videoEventsPlayTimePercent (videoEventType=75Percent)Metric
The number of video plays that reached 75% completion.
videoPlayStartCountMetric
The number of times a video ad started playing.
videoPlayTimePercentCount (videoEventType=25Percent)Metric
The number of times a video ad was played for at least 25% of its duration.
videoPlayTimePercentCount (videoEventType=50Percent)Metric
This metric indicates that 50% of a video ad has been viewed, based on the percentage of video watched.
videoPlayTimePercentCount (videoEventType=75Percent)Metric
This metric indicates that 75% of a video ad has been viewed, based on the percentage of video watched.
videoStartRateMetric
The rate at which video advertisements began playing, typically calculated as video starts divided by impressions or video load events.
viewImpressionsIABMetric
The number of ad impressions that met the IAB viewability standards.
viewImpressionsIAB (adUniqueness=campaignUnique)Metric
The number of unique impressions that were deemed viewable according to IAB standards within a campaign, counting each user once per campaign.
viewImpressionsIAB (adUniqueness=mediaUnique)Metric
The number of unique impressions that were deemed viewable according to IAB standards for a media asset, counting each user once per media.
visibility.firstLevelAreaMetric
The percentage of the ad's area that was visible for a 'first level' viewability measurement, which can be based on custom thresholds beyond standard IAB definitions.
visibility.firstLevelTimeMetric
The duration (in seconds) that the 'first level' of an ad's viewability criteria was met. This relates to custom viewability thresholds.
visibility.secondLevelAreaMetric
The percentage of the ad's area visible for a 'second level' viewability measurement, which is part of Adform's additional viewability services with custom thresholds.
visibility.secondLevelEnabledDimension
A boolean indicator specifying whether Adform's 'second level' viewability measurement service, which offers custom thresholds, is active for the campaign.
visibility.secondLevelTimeMetric
The duration (in seconds) that the 'second level' of an ad's viewability criteria was met. This relates to custom viewability thresholds from Adform's additional services.
visibility.thirdLevelAreaMetric
The percentage of the ad's area visible for a 'third level' viewability measurement, provided by Adform's additional viewability services with custom thresholds.
visibility.thirdLevelEnabledDimension
A boolean indicator specifying whether Adform's 'third level' viewability measurement service, which offers custom thresholds, is active for the campaign.
visibility.thirdLevelTimeMetric
The duration (in seconds) that the 'third level' of an ad's viewability criteria was met. This relates to custom viewability thresholds from Adform's additional services.
visitorsMetric
The number of unique visitors who interacted with the ad or website.
yearDimension
The year component of the date for which the data is reported.
yearIDMetric
The year component of the date for which the data is reported.
yearMonthDimension
A combined dimension representing the year and month of the data reporting period.