Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
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.

campaignBudgetAmountDimension
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.