Active Agent: Most-used fields#
The table below gives information about most-used fields that you can import from Active Agent. 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 |
|---|---|---|---|
ADVERTISER_FEE |
ADVERTISER_FEE |
The fee charged to the advertiser for running campaigns. |
metric |
ADVERTISER_ID |
ADVERTISER_ID |
The unique identifier for the advertiser. |
dimension |
AD_SLOT_ID |
AD_SLOT_ID |
Unique identifier for the ad slot where an ad is displayed. |
dimension |
AGENCY_ID |
AGENCY_ID |
The unique identifier for the agency managing the campaign. |
dimension |
AUCTION_PRICE_SUM |
AUCTION_PRICE_SUM |
The sum of auction prices for all winning bids. |
metric |
AUDIBLE_ADS |
AUDIBLE_ADS |
The number of audible ad impressions. This is a metric related to ad performance. |
metric |
BANNER_ID |
BANNER_ID |
The unique identifier for the ad banner. |
dimension |
BANNER_NAME |
BANNER_NAME |
The name of the ad banner. |
dimension |
BIDS_COSTS |
BIDS_COSTS |
The costs associated with bids placed for ad impressions. |
metric |
BID_SUM |
BID_SUM |
The sum of all bids placed in the auction. |
metric |
CAMPAIGN_ID |
CAMPAIGN_ID |
The unique identifier for the campaign. |
dimension |
CLICKS |
CLICKS |
The total number of clicks recorded for the ad. |
metric |
CONTACTS |
CONTACTS |
The number of unique users reached or exposed to an ad. |
metric |
CONTENTUNIT_ID |
CONTENTUNIT_ID |
Unique identifier for the content unit where ads are placed. |
dimension |
COUNT |
COUNT |
A standard metric representing a general count, such as the number of impressions or events. |
metric |
DATE |
DATE |
The specific date for which the data is reported. |
dimension |
DAY |
DAY |
The specific day of the month for which the data is reported. |
dimension |
DEAL |
DEAL |
An identifier for a programmatic advertising deal, used to filter or select specific deals, particularly relevant for perspective reports like PROGRAMMATIC_TV. |
dimension |
Date |
Date |
The specific date for which the data is reported. |
dimension |
EVENT_IMPRESSION_COUNT |
EVENT_IMPRESSION_COUNT |
The total number of times an ad banner was displayed to a user. |
metric |
GROSS_ADS |
GROSS_ADS |
The total number of gross ad impressions. |
metric |
MONTH |
MONTH |
The specific month for which the data is reported. |
dimension |
NETWORK_ID |
NETWORK_ID |
The unique identifier for the ad network. |
dimension |
NETWORK_NAME |
NETWORK_NAME |
The name of the advertising network where campaigns are run. |
dimension |
NET_COST |
NET_COST |
The net cost of the ad campaign after any deductions or fees. |
metric |
NET_DISPLAY_ADS |
NET_DISPLAY_ADS |
The net number of display ad impressions served after any adjustments. |
metric |
NET_DISPLAY_ELIGIBLE_IMPRESSIONS |
NET_DISPLAY_ELIGIBLE_IMPRESSIONS |
The number of display ad impressions that were eligible to be viewed. |
metric |
NET_DISPLAY_IAB_VIEWED_IMPRESSIONS |
NET_DISPLAY_IAB_VIEWED_IMPRESSIONS |
The number of display ad impressions that were measured as viewed according to IAB standards. |
metric |
NET_DISPLAY_MEASURED_IMPRESSIONS |
NET_DISPLAY_MEASURED_IMPRESSIONS |
The number of display ad impressions that were successfully measured. |
metric |
NET_VIDEO_ADS |
NET_VIDEO_ADS |
The net number of video ad impressions served after any adjustments. |
metric |
NET_VIDEO_ELIGIBLE_IMPRESSIONS |
NET_VIDEO_ELIGIBLE_IMPRESSIONS |
The number of video ad impressions that were eligible to be viewed. |
metric |
NET_VIDEO_IAB_VIEWED_IMPRESSIONS |
NET_VIDEO_IAB_VIEWED_IMPRESSIONS |
The number of video ad impressions that were measured as viewed according to IAB standards. |
metric |
NET_VIDEO_MEASURED_IMPRESSIONS |
NET_VIDEO_MEASURED_IMPRESSIONS |
The number of video ad impressions that were successfully measured. |
metric |
ORDER_ID |
ORDER_ID |
The unique identifier for the insertion order. |
dimension |
REFERRER |
REFERRER |
The URL of the page that referred the user to the current ad impression. |
dimension |
SSP |
SSP |
The Supply-Side Platform (SSP) through which the ad impression was purchased. |
dimension |
SUPPLY_PARTNER_ID |
SUPPLY_PARTNER_ID |
An identifier for the supply-side partner (SSP) or ad network responsible for delivering ad impressions. |
dimension |
TAGGING_COSTS |
TAGGING_COSTS |
Costs associated with ad tagging or creative serving. |
metric |
TECH_FEE |
TECH_FEE |
Fees charged for the use of advertising technology. |
metric |
THIRD_PARTY_COSTS |
THIRD_PARTY_COSTS |
Costs incurred from third-party vendors or services. |
metric |
TRAFFIC_TYPE |
TRAFFIC_TYPE |
The type of traffic associated with ad impressions, such as direct, referral, or programmatic. |
dimension |
TURNOVER_VIEWS |
TURNOVER_VIEWS |
The revenue generated from views of an advertisement. |
metric |
VIDEO_COMPLETE_IMPRESSIONS |
VIDEO_COMPLETE_IMPRESSIONS |
The number of video ad impressions that played to 100% completion. |
metric |
YEAR |
YEAR |
The specific year for which the data is reported. |
dimension |
banner.active |
banner.active |
Indicates if the banner is currently active and eligible for serving. |
dimension |
banner.activeThirdPartyFeatures |
banner.activeThirdPartyFeatures |
Features or functionalities activated for third-party integrations specifically for this banner. |
dimension |
banner.assetUrl |
banner.assetUrl |
The URL where the banner’s creative asset is hosted. |
dimension |
banner.campaignId |
banner.campaignId |
The unique identifier of the campaign to which the banner belongs. |
metric |
banner.childBannerIds |
banner.childBannerIds |
A list of unique identifiers for child banners that are logically grouped or associated with this parent banner. |
dimension |
banner.compatibleSsps |
banner.compatibleSsps |
A list of Supply-Side Platforms (SSPs) that are compatible with and can serve this banner. |
dimension |
banner.creativeUrl |
banner.creativeUrl |
The URL where the banner’s creative asset is hosted. |
dimension |
banner.deleted |
banner.deleted |
Indicates if the banner has been marked as deleted. |
dimension |
banner.filterIds |
banner.filterIds |
A list of identifiers for the filters applied to the banner, controlling its targeting or display. |
dimension |
banner.id |
banner.id |
The unique identifier for the ad banner. |
metric |
banner.infiniteRuntime |
banner.infiniteRuntime |
A boolean indicator specifying whether the banner is configured to run indefinitely without a set end date. |
dimension |
banner.landingPage |
banner.landingPage |
The landing page associated with the banner, where users are directed after clicking. |
dimension |
banner.lastUpdate |
banner.lastUpdate |
The timestamp of the last update made to the banner configuration. |
metric |
banner.name |
banner.name |
The name of the banner. |
dimension |
banner.networkId |
banner.networkId |
The unique identifier of the ad network associated with the banner. |
metric |
banner.runtime |
banner.runtime |
The specified duration or schedule during which the banner is configured to be active and displayed. |
dimension |
banner.ssl |
banner.ssl |
A boolean indicator specifying whether the banner is Secure Sockets Layer (SSL) compliant, meaning it can be served securely over HTTPS. |
dimension |
banner.status |
banner.status |
The current status of the banner (e.g., active, paused, archived). |
dimension |
banner.statusMessages |
banner.statusMessages |
Messages or alerts indicating the current operational status, any issues, or required actions for the banner. |
dimension |
banner.tcfCompliant |
banner.tcfCompliant |
Indicates whether the banner adheres to the IAB Transparency and Consent Framework (TCF) standards for user consent management. |
dimension |
banner.tcfVendors |
banner.tcfVendors |
A list of vendors associated with the banner that are compliant with the IAB Transparency and Consent Framework (TCF). |
dimension |
banner.templateId |
banner.templateId |
The identifier of the banner template used to create this banner. |
metric |
banner.trackingUrls |
banner.trackingUrls |
URLs used to track impressions, clicks, or other interactions with the banner. |
dimension |
banner.type |
banner.type |
The type of the banner (e.g., image, HTML5, video). |
dimension |
banner.valid |
banner.valid |
A boolean indicator showing whether the banner is currently considered valid for delivery based on its configuration and content. |
dimension |
campaign.active |
campaign.active |
Indicates if the campaign is currently active and running. |
dimension |
campaign.activeThirdPartyFeatures |
campaign.activeThirdPartyFeatures |
Features or functionalities activated for third-party integrations specifically for this campaign. |
dimension |
campaign.bannerIds |
campaign.bannerIds |
A list of identifiers for banners associated with this campaign. |
dimension |
campaign.bidFactorIds |
campaign.bidFactorIds |
A list of identifiers for bid factors applied to the campaign, influencing bid adjustments. |
dimension |
campaign.biddingStrategy |
campaign.biddingStrategy |
The bidding strategy configured for the campaign, which determines how bids are placed in ad auctions. |
dimension |
campaign.calculatedDailyBudget |
campaign.calculatedDailyBudget |
The daily budget calculated for the campaign based on its total budget and runtime. |
metric |
campaign.calculatedDailyImpressions |
campaign.calculatedDailyImpressions |
The estimated or projected number of ad impressions to be delivered daily for a campaign. |
metric |
campaign.dailyBudget |
campaign.dailyBudget |
The maximum budget allocated for the campaign on a daily basis. |
metric |
campaign.dailyImpressions |
campaign.dailyImpressions |
The total number of impressions recorded for the campaign on a daily basis. |
metric |
campaign.dailyPacing |
campaign.dailyPacing |
The daily pacing setting for the campaign, controlling the rate at which the daily budget is spent throughout the day. |
dimension |
campaign.deals |
campaign.deals |
A list of programmatic deals associated with the campaign. |
dimension |
campaign.deleted |
campaign.deleted |
Indicates if the campaign has been marked as deleted. |
dimension |
campaign.deliveryTechnique |
campaign.deliveryTechnique |
The specific method or strategy employed for serving ads within the campaign, such as standard, accelerated, or evenly distributed. |
dimension |
campaign.dsaBehalf |
campaign.dsaBehalf |
Indicates if the campaign’s advertisement is published ‘on behalf of’ another entity, as per Digital Services Act (DSA) transparency requirements. |
dimension |
campaign.dsaPaid |
campaign.dsaPaid |
Indicates if the campaign’s advertisement is explicitly marked as ‘paid for’ by a specific entity, as per Digital Services Act (DSA) transparency requirements. |
dimension |
campaign.filterIds |
campaign.filterIds |
A list of identifiers for the filters applied to the campaign, controlling its targeting or delivery. |
dimension |
campaign.id |
campaign.id |
The unique identifier for the campaign. |
dimension |
campaign.infiniteRuntime |
campaign.infiniteRuntime |
Indicates whether the campaign is configured to run indefinitely without an end date. |
dimension |
campaign.lastUpdate |
campaign.lastUpdate |
The timestamp of the last update made to the campaign configuration. |
metric |
campaign.maxCpcv |
campaign.maxCpcv |
The maximum bid or cap set for the Cost Per Completed View (CPCV) metric for this campaign, typically used for video advertising. |
metric |
campaign.maxCpm |
campaign.maxCpm |
The maximum Cost Per Mille (CPM) bid set for the campaign. |
metric |
campaign.minVtr |
campaign.minVtr |
The minimum acceptable View-Through Rate (VTR) target for the campaign, indicating the desired percentage of impressions that result in a completed view. |
metric |
campaign.name |
campaign.name |
The name of the campaign. |
dimension |
campaign.networkId |
campaign.networkId |
The unique identifier of the ad network associated with the campaign. |
metric |
campaign.optimization |
campaign.optimization |
The optimization strategy applied to the campaign to improve performance based on defined goals (e.g., clicks, conversions). |
dimension |
campaign.orderId |
campaign.orderId |
The unique identifier of the order to which the campaign belongs. |
metric |
campaign.pace |
campaign.pace |
The pacing strategy or setting that controls the speed at which the campaign’s budget is spent. |
metric |
campaign.runtimePacing |
campaign.runtimePacing |
The runtime pacing setting for the campaign, which distributes the budget evenly across the campaign’s entire duration. |
dimension |
campaign.runtimePacingFactor |
campaign.runtimePacingFactor |
A factor that influences how the campaign’s budget is paced over its runtime. |
metric |
campaign.runtimes |
campaign.runtimes |
The configured schedules or periods defining when the campaign is active and eligible for ad delivery. |
dimension |
campaign.templateId |
campaign.templateId |
The unique identifier of the template used to create or configure this campaign, streamlining setup. |
metric |
campaign.thirdPartyCostIds |
campaign.thirdPartyCostIds |
A list of identifiers associated with costs or fees from third-party vendors or services involved in the campaign. |
dimension |
campaign.totalBudget |
campaign.totalBudget |
The overall total budget allocated for the campaign’s entire duration. |
metric |
campaign.totalImpressions |
campaign.totalImpressions |
The cumulative total number of ad impressions delivered over the entire duration of a campaign. |
metric |
campaign.trackingPageIds |
campaign.trackingPageIds |
A list of identifiers for tracking pages or pixels used to monitor conversions or events related to the campaign. |
dimension |
campaign.type |
campaign.type |
The type of the campaign (e.g., branding, performance, video). |
dimension |
network.accessibleFeatures |
network.accessibleFeatures |
A list of features and functionalities that are enabled or available for use within this specific advertising network. |
dimension |
network.adFarmId |
network.adFarmId |
Unique identifier for the ad farm associated with the network. |
metric |
network.companyIds |
network.companyIds |
A list of identifiers for companies associated with the network. |
dimension |
network.deleted |
network.deleted |
Indicates if the network has been marked as deleted. |
dimension |
network.hasHostingFee |
network.hasHostingFee |
Indicates if the network has an associated hosting fee. |
dimension |
network.id |
network.id |
The unique identifier for the ad network. |
metric |
network.isDmp |
network.isDmp |
A boolean indicator specifying whether the network also functions as a Data Management Platform (DMP), providing audience data and segmentation capabilities. |
dimension |
network.isEnabledForRedirectCampaigns |
network.isEnabledForRedirectCampaigns |
A boolean indicator specifying whether the advertising network is configured and enabled to support campaigns that utilize redirect-based ad delivery. |
dimension |
network.lastUpdate |
network.lastUpdate |
The timestamp of the last update made to the network configuration. |
metric |
network.name |
network.name |
The name of the ad network. |
dimension |
network.somThirdPartyUplift |
network.somThirdPartyUplift |
The uplift value for third-party costs specific to ‘Something Other’ (SOM) within the network. |
metric |
network.thirdPartyUplift |
network.thirdPartyUplift |
The percentage or value uplift applied by third parties at the network level, potentially impacting costs or revenue. |
metric |
order.activeThirdPartyFeatures |
order.activeThirdPartyFeatures |
Features or functionalities activated for third-party integrations specifically for this advertising order. |
dimension |
order.advertiserId |
order.advertiserId |
The unique identifier of the advertiser associated with the order. |
metric |
order.agencyId |
order.agencyId |
The unique identifier of the agency associated with the order. |
metric |
order.calculatedDailyBudget |
order.calculatedDailyBudget |
The daily budget calculated for the order based on its total budget and runtime. |
metric |
order.calculatedDailyImpressions |
order.calculatedDailyImpressions |
The estimated or projected number of ad impressions to be delivered daily for an advertising order. |
metric |
order.campaignIds |
order.campaignIds |
A list of identifiers for campaigns associated with this order. |
dimension |
order.dailyBudget |
order.dailyBudget |
The maximum budget allocated for the order on a daily basis. |
metric |
order.dailyPacing |
order.dailyPacing |
The daily pacing setting for the order, controlling the rate at which the daily budget is spent throughout the day. |
dimension |
order.deleted |
order.deleted |
Indicates if the order has been marked as deleted. |
dimension |
order.dsaBehalf |
order.dsaBehalf |
Indicates if the advertising order’s creatives are published ‘on behalf of’ another entity, as per Digital Services Act (DSA) transparency requirements. |
dimension |
order.dsaPaid |
order.dsaPaid |
Indicates if the advertising order’s creatives are explicitly marked as ‘paid for’ by a specific entity, as per Digital Services Act (DSA) transparency requirements. |
dimension |
order.id |
order.id |
The unique identifier for the order. |
dimension |
order.lastUpdate |
order.lastUpdate |
The timestamp of the last update made to the order configuration. |
metric |
order.name |
order.name |
The name of the order. |
dimension |
order.networkId |
order.networkId |
The unique identifier of the ad network associated with the order. |
dimension |
order.pace |
order.pace |
The pacing strategy or setting that controls the speed at which the order’s budget is spent. |
metric |
order.runtimeBudgets |
order.runtimeBudgets |
The budget allocations and limits defined for different runtime periods or phases of the advertising order. |
dimension |
order.runtimePacing |
order.runtimePacing |
The runtime pacing setting for the order, which distributes the budget evenly across the order’s entire duration. |
dimension |
order.runtimePacingFactor |
order.runtimePacingFactor |
A factor that influences how the order’s budget is paced over its runtime. |
metric |
order.totalBudget |
order.totalBudget |
The overall total budget allocated for the order’s entire duration. |
metric |
order.totalImpressions |
order.totalImpressions |
The cumulative total number of ad impressions delivered over the entire duration of an advertising order. |
metric |
placement_id |
placement_id |
Unique identifier for the ad placement. |
dimension |