Google Ad Manager: Most-used fields#
The table below gives information about most-used fields that you can import from Google Ad Manager. 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.
ADSENSE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS Dimension
The total number of impressions delivered by AdSense ads that were technically capable of measuring viewability. These impressions are associated with an Active View-enabled ad tag and have successfully communicated with Google's servers.
ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS Dimension
The number of AdSense ad impressions that Active View technology was actually able to measure for viewability. This is a subset of all eligible impressions.
ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS Dimension
The number of AdSense ad impressions that were considered viewable according to MRC standards. These are a subset of measurable impressions, meaning they appeared within a user's browser and had the opportunity to be seen, based on criteria like percentage of pixels visible and duration.
ADSENSE_LINE_ITEM_LEVEL_IMPRESSIONS Dimension
The number of impressions delivered by an AdSense ad for line item-level dynamic allocation. This metric corresponds to 'AdSense impressions' in the Ad Manager UI.
ADSENSE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS Dimension
The number of impressions delivered by an AdSense ad for line item-level dynamic allocation that specifically matched explicit custom criteria targeting.
ADVERTISER_DOMAIN_NAME Dimension
The domain name of the advertiser.
ADVERTISER_ID Dimension
The unique identifier of the advertiser.
ADVERTISER_NAME Dimension
The name of the advertiser.
ADVERTISER_VERTICAL_NAME Dimension
The industry vertical or category of the advertiser (e.g., Automotive, Retail).
AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS Metric
The number of Ad Exchange ad impressions that were eligible to be measured by Active View.
AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS Dimension
The number of Ad Exchange ad impressions that Active View technology was actually able to measure for viewability. This is a subset of all eligible Ad Exchange impressions.
AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE Metric
The percentage of Ad Exchange Active View measurable impressions that were actually viewable.
AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKS Metric
The number of clicks recorded for Ad Exchange ads at the line item level.
AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS Dimension
The number of impressions delivered by an Ad Exchange ad for line item-level dynamic allocation. This metric corresponds to 'Ad Exchange impressions' in the Ad Manager UI.
AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS Dimension
The number of impressions delivered by an Ad Exchange ad for line item-level dynamic allocation that specifically matched explicit custom criteria targeting. This metric corresponds to 'Ad Exchange targeted impressions' in the Ad Manager UI.
AD_SERVER_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME Metric
The average duration, in milliseconds, that an ad server impression was viewable according to Active View metrics.
AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS Metric
The count of ad server impressions for which Active View measurement was possible.
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS Metric
The count of ad server impressions that were considered viewable based on Active View standards.
AD_SERVER_ALL_REVENUE Metric
The total revenue generated from all ad impressions served by the ad server.
AD_SERVER_ALL_REVENUE_GROSS Metric
The total gross revenue generated from all ad impressions served by the ad server, before any deductions.
AD_SERVER_CLICKS Metric
The total number of clicks recorded on ads served by the ad server.
AD_SERVER_CPD_REVENUE Metric
The revenue generated from ad server impressions billed on a Cost-Per-Day (CPD) basis.
AD_SERVER_CPM_AND_CPC_REVENUE Metric
The revenue generated from ad server impressions billed on a Cost-Per-Mille (CPM) or Cost-Per-Click (CPC) basis.
AD_SERVER_CPM_AND_CPC_REVENUE_GROSS Metric
The gross revenue generated from ad server impressions billed on a Cost-Per-Mille (CPM) or Cost-Per-Click (CPC) basis, before any deductions.
AD_SERVER_CTR Metric
The click-through rate (clicks divided by impressions) for ads served by the ad server.
AD_SERVER_IMPRESSIONS Metric
The total number of ad impressions served by the ad server.
AD_SIZE Dimension
The dimensions (width x height) of the ad creative.
AD_TYPE_ID Dimension
The unique identifier for the type of ad.
AD_TYPE_NAME Dimension
The name associated with the type of ad.
AD_UNIT Dimension
The specific ad unit within the inventory hierarchy where the ad was displayed.
AD_UNIT_ID Dimension
The unique identifier for the ad unit.
AD_UNIT_NAME Dimension
The name of the ad unit.
AUDIENCE_SEGMENT_ID Dimension
A unique identifier for an audience segment, which represents a grouping of users with shared characteristics for ad targeting. This ID is used to manage and retrieve audience segments.
AUDIENCE_SEGMENT_NAME Dimension
The human-readable name of the audience segment. This name is used for identification and filtering audience segments in reports and the Ad Manager UI.
BUYER_NETWORK_ID Dimension
The unique identifier for the buyer network associated with programmatic ad transactions.
BUYER_NETWORK_NAME Dimension
The name of the buyer network associated with programmatic ad transactions.
CARRIER_NAME Dimension
The name of the mobile carrier network through which the ad was served.
CHANNEL_NAME Dimension
Categorizes reporting data by channels, which represent logical groupings of inventory within the Ad Manager platform. This dimension corresponds to 'Channel' in the Ad Manager UI and is compatible with the Historical report type, enabling analysis of ad performance within defined channels.
COUNTRY_CODE Dimension
The ISO-3166-1 alpha-2 country code associated with a geographic target. This code represents the country where an ad request originated or was targeted.
COUNTRY_CRITERIA_ID Dimension
The unique ID for a country used in targeting criteria. This dimension breaks down reporting data by this ID, and the country name is automatically included in the report.
COUNTRY_NAME Dimension
The human-readable name of the country. This dimension breaks down reporting data by country name and can be used for filtering, with the country criteria ID also automatically included.
CREATIVE_ID Dimension
The unique identifier for the creative.
CREATIVE_NAME Dimension
The name of the creative.
CREATIVE_SIZE Dimension
The dimensions (width x height) of the creative as defined in the system.
CREATIVE_SIZE_DELIVERED Dimension
The actual dimensions (width x height) of the creative that was served.
CREATIVE_TYPE Dimension
The type of creative that was served (e.g., image, HTML5, video).
DATE Dimension
The specific date for which the report data is aggregated.
DEMAND_CHANNEL_ID Metric
The unique identifier for the demand channel through which the ad impression was generated.
DEMAND_CHANNEL_NAME Dimension
The name of the demand channel through which the ad impression was generated.
DEVICE_CATEGORY_ID Dimension
The unique identifier for the category of device used (e.g., desktop, tablet, mobile).
DEVICE_CATEGORY_NAME Dimension
The name of the device category (e.g., Desktop, High-end mobile device, Tablet).
FORECASTED_CREATIVE_RESTRICTION Dimension
Indicates if a creative restriction was applied during the forecast to limit eligible creatives.
FORECASTED_CREATIVE_RESTRICTION_EXCLUDED Dimension
Indicates if a creative restriction was explicitly excluded from the forecast calculation.
LINE_ITEM_COMPUTED_STATUS Dimension
The system-determined status of the line item (e.g., active, paused, completed, draft).
LINE_ITEM_COST_TYPE Dimension
The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).
LINE_ITEM_CREATIVE_END_DATE Dimension
The end date and time when a specific creative associated with a line item is scheduled to stop serving.
LINE_ITEM_CREATIVE_START_DATE Dimension
The start date and time when a specific creative associated with a line item is scheduled to begin serving.
LINE_ITEM_DELIVERY_INDICATOR Metric
An indicator showing the current pace or status of a line item's delivery.
LINE_ITEM_DELIVERY_PACING Dimension
The method used to distribute the delivery of a line item over its duration (e.g., Evenly, Frontloaded).
LINE_ITEM_END_DATE_TIME Dimension
The date and time when the line item is scheduled to stop serving.
LINE_ITEM_FREQUENCY_CAP Dimension
The limit on how many times an individual user can see an ad from this line item within a given period.
LINE_ITEM_GOAL_QUANTITY Dimension
The total number of impressions or clicks targeted for delivery by the line item.
LINE_ITEM_ID Dimension
The unique identifier for the line item.
LINE_ITEM_LABELS Dimension
The labels (categories or attributes) that have been applied to the line item.
LINE_ITEM_NAME Dimension
The name of the line item.
LINE_ITEM_NON_CPD_BOOKED_REVENUE Metric
The booked revenue for line items that are not based on a Cost-Per-Day (CPD) pricing model.
LINE_ITEM_PRIORITY Metric
The numerical priority assigned to the line item, influencing its serving order against other line items.
LINE_ITEM_START_DATE_TIME Dimension
The date and time when the line item is scheduled to begin serving.
LINE_ITEM_TYPE Dimension
The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.
MASTER_COMPANION_CREATIVE_ID Dimension
The unique identifier assigned to a companion creative that is served alongside a master creative within a creative set. Companion creatives are supplementary ads that appear with a master ad.
MASTER_COMPANION_CREATIVE_NAME Dimension
The user-defined name of a companion creative that is associated with a master creative in a creative set. Companion creatives are display ads that can be served simultaneously with a video or audio master ad.
MONTH_AND_YEAR Dimension
The month and year of the ad event.
OPERATING_SYSTEM_VERSION_ID Dimension
The unique ID that identifies a specific version of an operating system. This ID is used for targeting and reporting on ad delivery across different OS versions.
OPERATING_SYSTEM_VERSION_NAME Dimension
The human-readable name of a specific operating system version. This name helps identify and report on ad performance across various OS versions.
ORDER_AGENCY Dimension
The advertising agency associated with the order.
ORDER_AGENCY_ID Dimension
The unique identifier for the advertising agency associated with the order.
ORDER_END_DATE_TIME Dimension
The date and time when the order is scheduled to conclude.
ORDER_ID Dimension
The unique identifier for the order.
ORDER_LABELS Dimension
The labels (categories or attributes) that have been applied to the order.
ORDER_NAME Dimension
The name of the order.
ORDER_SALESPERSON Dimension
The salesperson responsible for the order.
ORDER_START_DATE_TIME Dimension
The date and time when the order is scheduled to begin.
ORDER_TRAFFICKER Dimension
The ad operations professional responsible for implementing and managing the order.
Order Type Dimension
The classification of an order, which is a grouping of line items in Google Ad Manager.
PLACEMENT_ID Dimension
The unique identifier for the ad placement.
PLACEMENT_NAME Dimension
The name of the ad placement.
PROGRAMMATIC_CHANNEL_NAME Dimension
The name of the programmatic channel that served the ad.
REGION_CRITERIA_ID Dimension
The unique ID for a geographic region used in targeting criteria. This dimension breaks down reporting data by this ID, with the region name automatically included in the report.
REGION_NAME Dimension
The human-readable name of a geographic region. This dimension breaks down reporting data by region name and can be used for filtering, with the region criteria ID also automatically included.
REQUEST_TYPE Dimension
The method or classification of an ad request sent to the ad server. This can include various types of requests, such as standard ad requests, delayed-impression requests, or those for real-time video.
SALESPERSON_ID Dimension
The unique identifier for the salesperson.
TOTAL_CONVERSIONS Metric
The total number of conversion events recorded across the network.
TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONS Metric
The total number of ad requests that were not filled with an ad across all inventory.
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE Metric
The total revenue generated from all sources at the line item level.
TOTAL_LINE_ITEM_LEVEL_CLICKS Metric
The total number of clicks generated by line items.
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE Metric
The total revenue generated from Cost-Per-Mille (CPM) and Cost-Per-Click (CPC) models at the line item level.
TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS Metric
The total number of impressions recorded for ads at the line item level.
UNIQUE_REACH_IMPRESSIONS Dimension
The total number of impressions delivered to unique users within a specific reach report. This metric helps to understand the unique audience reached by ads.
VIDEO_INTERACTION_VIDEO_SKIPS Dimension
The total number of times viewers chose to skip a video ad.
VIDEO_VIEWERSHIP_COMPLETE Metric
Indicates that a video ad was played to 100% completion.
VIDEO_VIEWERSHIP_START Metric
Indicates that a video ad began playing.
availableUnits Metric
The number of ad units (impressions or clicks) that are available for a given line item based on forecasting.
costPerUnit Metric
The cost per unit defined for the line item.
costType Dimension
The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).
creativePlaceholders Dimension
This field defines the dimensions (sizes) expected for creatives associated with a Line Item. Creatives linked to the Line Item must have sizes that are a subset of the specified creative placeholders.
customFields Dimension
Custom key-value pairs associated with an entity, providing additional configurable attributes.
deliveredUnits Metric
The number of ad units (impressions or clicks) that have been successfully delivered for a line item to date.
discount Metric
This field specifies the type of discount applied to the cost of booking a Line Item. Discounts can be an ABSOLUTE_VALUE (a fixed amount) or a PERCENTAGE of the Line Item's cost.
discountType Dimension
Describes the type of discount applied to the cost of a line item. This can be either an absolute monetary value or a percentage of the line item's cost.
externalId Dimension
A unique identifier for the entity as recognized by an external system or integrated platform.
forecastEndDate Dimension
The end date for the period covered by the forecast.
forecastRunDate Dimension
The date on which the inventory forecast was generated.
forecastStartDate Dimension
The start date for the period covered by the forecast.
id Dimension
The unique system-generated identifier for a specific entity.
lineItemType Dimension
The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.
matchedUnits Metric
The number of ad units (impressions or clicks) that matched the targeting criteria of the line item.
name Dimension
The human-readable name of the entity.
orderAdvertiserid Metric
The unique identifier of the advertiser associated with the order.
orderAdvertisername Dimension
The name of the advertiser associated with the order.
orderAppliedlabels Dimension
The labels (categories or attributes) that have been applied to the order.
orderCustomFields Dimension
Custom key-value pairs associated with the order, providing additional configurable attributes.
orderCustomfields Dimension
Custom key-value pairs associated with the order, providing additional configurable attributes.
orderEnddatetime Dimension
The date and time when the order is scheduled to conclude.
orderExternalorderid Metric
The unique identifier for the order as it exists in an external order management system.
orderId Metric
The unique identifier for the order.
orderName Dimension
The name of the order.
orderPonumber Dimension
The purchase order (PO) number associated with the order.
orderStartdatetime Dimension
The date and time when the order is scheduled to begin.
possibleUnits Metric
Represents the various types of units that can be used for forecasting or setting delivery goals within Google Ad Manager. These units determine how inventory is measured and reserved for line items, such as impressions, clicks, or completed views.
priority Metric
The numerical priority assigned to the line item, influencing its serving order against other line items.
requestPlatformTargeting Dimension
Specifies targeting based on the platform where the ad request originated (e.g., Web, Mobile Web, Mobile Application).
reservedUnits Metric
The number of ad units (impressions or clicks) that are reserved by competing line items, impacting availability.
servingEndTime Dimension
The end date and time when an ad or campaign stopped serving.
startDateTime Dimension
The start date and time when an ad or campaign began serving.
target customTargeting Dimension
Defines the specific ad inventory (e.g., ad units, key-values, geographical locations) that a line item is configured to target for ad delivery.
unitType Dimension
The type of unit used for pricing or inventory, such as impressions, clicks, or time.
videoPositionTargeting Dimension
Specifies targeting based on the position of the video ad within video content (e.g., pre-roll, mid-roll, post-roll).