Active Agent: Most-used fields

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