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.

API name	Adverity UI name	Description	Use in Adverity
ADSENSE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS	ADSENSE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS	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.	dimension
ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	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.	dimension
ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS	ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS	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.	dimension
ADSENSE_LINE_ITEM_LEVEL_IMPRESSIONS	ADSENSE_LINE_ITEM_LEVEL_IMPRESSIONS	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.	dimension
ADSENSE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS	ADSENSE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS	The number of impressions delivered by an AdSense ad for line item-level dynamic allocation that specifically matched explicit custom criteria targeting.	dimension
ADVERTISER_DOMAIN_NAME	ADVERTISER_DOMAIN_NAME	The domain name of the advertiser.	dimension
ADVERTISER_ID	ADVERTISER_ID	The unique identifier of the advertiser.	dimension
ADVERTISER_NAME	ADVERTISER_NAME	The name of the advertiser.	dimension
ADVERTISER_VERTICAL_NAME	ADVERTISER_VERTICAL_NAME	The industry vertical or category of the advertiser (e.g., Automotive, Retail).	dimension
AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS	AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS	The number of Ad Exchange ad impressions that were eligible to be measured by Active View.	metric
AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	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.	dimension
AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE	AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE	The percentage of Ad Exchange Active View measurable impressions that were actually viewable.	metric
AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKS	AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKS	The number of clicks recorded for Ad Exchange ads at the line item level.	metric
AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS	AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS	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.	dimension
AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS	AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS	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.	dimension
AD_SERVER_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME	AD_SERVER_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME	The average duration, in milliseconds, that an ad server impression was viewable according to Active View metrics.	metric
AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS	The count of ad server impressions for which Active View measurement was possible.	metric
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS	AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS	The count of ad server impressions that were considered viewable based on Active View standards.	metric
AD_SERVER_ALL_REVENUE	AD_SERVER_ALL_REVENUE	The total revenue generated from all ad impressions served by the ad server.	metric
AD_SERVER_ALL_REVENUE_GROSS	AD_SERVER_ALL_REVENUE_GROSS	The total gross revenue generated from all ad impressions served by the ad server, before any deductions.	metric
AD_SERVER_CLICKS	AD_SERVER_CLICKS	The total number of clicks recorded on ads served by the ad server.	metric
AD_SERVER_CPD_REVENUE	AD_SERVER_CPD_REVENUE	The revenue generated from ad server impressions billed on a Cost-Per-Day (CPD) basis.	metric
AD_SERVER_CPM_AND_CPC_REVENUE	AD_SERVER_CPM_AND_CPC_REVENUE	The revenue generated from ad server impressions billed on a Cost-Per-Mille (CPM) or Cost-Per-Click (CPC) basis.	metric
AD_SERVER_CPM_AND_CPC_REVENUE_GROSS	AD_SERVER_CPM_AND_CPC_REVENUE_GROSS	The gross revenue generated from ad server impressions billed on a Cost-Per-Mille (CPM) or Cost-Per-Click (CPC) basis, before any deductions.	metric
AD_SERVER_CTR	AD_SERVER_CTR	The click-through rate (clicks divided by impressions) for ads served by the ad server.	metric
AD_SERVER_IMPRESSIONS	AD_SERVER_IMPRESSIONS	The total number of ad impressions served by the ad server.	metric
AD_SIZE	AD_SIZE	The dimensions (width x height) of the ad creative.	dimension
AD_TYPE_ID	AD_TYPE_ID	The unique identifier for the type of ad.	dimension
AD_TYPE_NAME	AD_TYPE_NAME	The name associated with the type of ad.	dimension
AD_UNIT	AD_UNIT	The specific ad unit within the inventory hierarchy where the ad was displayed.	dimension
AD_UNIT_ID	AD_UNIT_ID	The unique identifier for the ad unit.	dimension
AD_UNIT_NAME	AD_UNIT_NAME	The name of the ad unit.	dimension
AUDIENCE_SEGMENT_ID	AUDIENCE_SEGMENT_ID	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.	dimension
AUDIENCE_SEGMENT_NAME	AUDIENCE_SEGMENT_NAME	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.	dimension
BUYER_NETWORK_ID	BUYER_NETWORK_ID	The unique identifier for the buyer network associated with programmatic ad transactions.	dimension
BUYER_NETWORK_NAME	BUYER_NETWORK_NAME	The name of the buyer network associated with programmatic ad transactions.	dimension
CARRIER_NAME	CARRIER_NAME	The name of the mobile carrier network through which the ad was served.	dimension
CHANNEL_NAME	CHANNEL_NAME	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.	dimension
COUNTRY_CODE	COUNTRY_CODE	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.	dimension
COUNTRY_CRITERIA_ID	COUNTRY_CRITERIA_ID	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.	dimension
COUNTRY_NAME	COUNTRY_NAME	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.	dimension
CREATIVE_ID	CREATIVE_ID	The unique identifier for the creative.	dimension
CREATIVE_NAME	CREATIVE_NAME	The name of the creative.	dimension
CREATIVE_SIZE	CREATIVE_SIZE	The dimensions (width x height) of the creative as defined in the system.	dimension
CREATIVE_SIZE_DELIVERED	CREATIVE_SIZE_DELIVERED	The actual dimensions (width x height) of the creative that was served.	dimension
CREATIVE_TYPE	CREATIVE_TYPE	The type of creative that was served (e.g., image, HTML5, video).	dimension
DATE	DATE	The specific date for which the report data is aggregated.	dimension
DEMAND_CHANNEL_ID	DEMAND_CHANNEL_ID	The unique identifier for the demand channel through which the ad impression was generated.	metric
DEMAND_CHANNEL_NAME	DEMAND_CHANNEL_NAME	The name of the demand channel through which the ad impression was generated.	dimension
DEVICE_CATEGORY_ID	DEVICE_CATEGORY_ID	The unique identifier for the category of device used (e.g., desktop, tablet, mobile).	dimension
DEVICE_CATEGORY_NAME	DEVICE_CATEGORY_NAME	The name of the device category (e.g., Desktop, High-end mobile device, Tablet).	dimension
FORECASTED_CREATIVE_RESTRICTION	FORECASTED_CREATIVE_RESTRICTION	Indicates if a creative restriction was applied during the forecast to limit eligible creatives.	dimension
FORECASTED_CREATIVE_RESTRICTION_EXCLUDED	FORECASTED_CREATIVE_RESTRICTION_EXCLUDED	Indicates if a creative restriction was explicitly excluded from the forecast calculation.	dimension
LINE_ITEM_COMPUTED_STATUS	LINE_ITEM_COMPUTED_STATUS	The system-determined status of the line item (e.g., active, paused, completed, draft).	dimension
LINE_ITEM_COST_TYPE	LINE_ITEM_COST_TYPE	The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).	dimension
LINE_ITEM_CREATIVE_END_DATE	LINE_ITEM_CREATIVE_END_DATE	The end date and time when a specific creative associated with a line item is scheduled to stop serving.	dimension
LINE_ITEM_CREATIVE_START_DATE	LINE_ITEM_CREATIVE_START_DATE	The start date and time when a specific creative associated with a line item is scheduled to begin serving.	dimension
LINE_ITEM_DELIVERY_INDICATOR	LINE_ITEM_DELIVERY_INDICATOR	An indicator showing the current pace or status of a line item’s delivery.	metric
LINE_ITEM_DELIVERY_PACING	LINE_ITEM_DELIVERY_PACING	The method used to distribute the delivery of a line item over its duration (e.g., Evenly, Frontloaded).	dimension
LINE_ITEM_END_DATE_TIME	LINE_ITEM_END_DATE_TIME	The date and time when the line item is scheduled to stop serving.	dimension
LINE_ITEM_FREQUENCY_CAP	LINE_ITEM_FREQUENCY_CAP	The limit on how many times an individual user can see an ad from this line item within a given period.	dimension
LINE_ITEM_GOAL_QUANTITY	LINE_ITEM_GOAL_QUANTITY	The total number of impressions or clicks targeted for delivery by the line item.	dimension
LINE_ITEM_ID	LINE_ITEM_ID	The unique identifier for the line item.	dimension
LINE_ITEM_LABELS	LINE_ITEM_LABELS	The labels (categories or attributes) that have been applied to the line item.	dimension
LINE_ITEM_NAME	LINE_ITEM_NAME	The name of the line item.	dimension
LINE_ITEM_NON_CPD_BOOKED_REVENUE	LINE_ITEM_NON_CPD_BOOKED_REVENUE	The booked revenue for line items that are not based on a Cost-Per-Day (CPD) pricing model.	metric
LINE_ITEM_PRIORITY	LINE_ITEM_PRIORITY	The numerical priority assigned to the line item, influencing its serving order against other line items.	metric
LINE_ITEM_START_DATE_TIME	LINE_ITEM_START_DATE_TIME	The date and time when the line item is scheduled to begin serving.	dimension
LINE_ITEM_TYPE	LINE_ITEM_TYPE	The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.	dimension
MASTER_COMPANION_CREATIVE_ID	MASTER_COMPANION_CREATIVE_ID	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.	dimension
MASTER_COMPANION_CREATIVE_NAME	MASTER_COMPANION_CREATIVE_NAME	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.	dimension
MONTH_AND_YEAR	MONTH_AND_YEAR	The month and year of the ad event.	dimension
OPERATING_SYSTEM_VERSION_ID	OPERATING_SYSTEM_VERSION_ID	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.	dimension
OPERATING_SYSTEM_VERSION_NAME	OPERATING_SYSTEM_VERSION_NAME	The human-readable name of a specific operating system version. This name helps identify and report on ad performance across various OS versions.	dimension
ORDER_AGENCY	ORDER_AGENCY	The advertising agency associated with the order.	dimension
ORDER_AGENCY_ID	ORDER_AGENCY_ID	The unique identifier for the advertising agency associated with the order.	dimension
ORDER_END_DATE_TIME	ORDER_END_DATE_TIME	The date and time when the order is scheduled to conclude.	dimension
ORDER_ID	ORDER_ID	The unique identifier for the order.	dimension
ORDER_LABELS	ORDER_LABELS	The labels (categories or attributes) that have been applied to the order.	dimension
ORDER_NAME	ORDER_NAME	The name of the order.	dimension
ORDER_SALESPERSON	ORDER_SALESPERSON	The salesperson responsible for the order.	dimension
ORDER_START_DATE_TIME	ORDER_START_DATE_TIME	The date and time when the order is scheduled to begin.	dimension
ORDER_TRAFFICKER	ORDER_TRAFFICKER	The ad operations professional responsible for implementing and managing the order.	dimension
Order Type	Order Type	The classification of an order, which is a grouping of line items in Google Ad Manager.	dimension
PLACEMENT_ID	PLACEMENT_ID	The unique identifier for the ad placement.	dimension
PLACEMENT_NAME	PLACEMENT_NAME	The name of the ad placement.	dimension
PROGRAMMATIC_CHANNEL_NAME	PROGRAMMATIC_CHANNEL_NAME	The name of the programmatic channel that served the ad.	dimension
REGION_CRITERIA_ID	REGION_CRITERIA_ID	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.	dimension
REGION_NAME	REGION_NAME	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.	dimension
REQUEST_TYPE	REQUEST_TYPE	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.	dimension
SALESPERSON_ID	SALESPERSON_ID	The unique identifier for the salesperson.	dimension
TOTAL_CONVERSIONS	TOTAL_CONVERSIONS	The total number of conversion events recorded across the network.	metric
TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONS	TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONS	The total number of ad requests that were not filled with an ad across all inventory.	metric
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE	TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE	The total revenue generated from all sources at the line item level.	metric
TOTAL_LINE_ITEM_LEVEL_CLICKS	TOTAL_LINE_ITEM_LEVEL_CLICKS	The total number of clicks generated by line items.	metric
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE	TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE	The total revenue generated from Cost-Per-Mille (CPM) and Cost-Per-Click (CPC) models at the line item level.	metric
TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS	TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS	The total number of impressions recorded for ads at the line item level.	metric
UNIQUE_REACH_IMPRESSIONS	UNIQUE_REACH_IMPRESSIONS	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.	dimension
VIDEO_INTERACTION_VIDEO_SKIPS	VIDEO_INTERACTION_VIDEO_SKIPS	The total number of times viewers chose to skip a video ad.	dimension
VIDEO_VIEWERSHIP_COMPLETE	VIDEO_VIEWERSHIP_COMPLETE	Indicates that a video ad was played to 100% completion.	metric
VIDEO_VIEWERSHIP_START	VIDEO_VIEWERSHIP_START	Indicates that a video ad began playing.	metric
availableUnits	availableUnits	The number of ad units (impressions or clicks) that are available for a given line item based on forecasting.	metric
costPerUnit	costPerUnit	The cost per unit defined for the line item.	metric
costType	costType	The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).	dimension
creativePlaceholders	creativePlaceholders	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.	dimension
customFields	customFields	Custom key-value pairs associated with an entity, providing additional configurable attributes.	dimension
deliveredUnits	deliveredUnits	The number of ad units (impressions or clicks) that have been successfully delivered for a line item to date.	metric
discount	discount	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.	metric
discountType	discountType	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.	dimension
externalId	externalId	A unique identifier for the entity as recognized by an external system or integrated platform.	dimension
forecastEndDate	forecastEndDate	The end date for the period covered by the forecast.	dimension
forecastRunDate	forecastRunDate	The date on which the inventory forecast was generated.	dimension
forecastStartDate	forecastStartDate	The start date for the period covered by the forecast.	dimension
id	id	The unique system-generated identifier for a specific entity.	dimension
lineItemType	lineItemType	The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.	dimension
matchedUnits	matchedUnits	The number of ad units (impressions or clicks) that matched the targeting criteria of the line item.	metric
name	name	The human-readable name of the entity.	dimension
orderAdvertiserid	orderAdvertiserid	The unique identifier of the advertiser associated with the order.	metric
orderAdvertisername	orderAdvertisername	The name of the advertiser associated with the order.	dimension
orderAppliedlabels	orderAppliedlabels	The labels (categories or attributes) that have been applied to the order.	dimension
orderCustomFields	orderCustomFields	Custom key-value pairs associated with the order, providing additional configurable attributes.	dimension
orderCustomfields	orderCustomfields	Custom key-value pairs associated with the order, providing additional configurable attributes.	dimension
orderEnddatetime	orderEnddatetime	The date and time when the order is scheduled to conclude.	dimension
orderExternalorderid	orderExternalorderid	The unique identifier for the order as it exists in an external order management system.	metric
orderId	orderId	The unique identifier for the order.	metric
orderName	orderName	The name of the order.	dimension
orderPonumber	orderPonumber	The purchase order (PO) number associated with the order.	dimension
orderStartdatetime	orderStartdatetime	The date and time when the order is scheduled to begin.	dimension
possibleUnits	possibleUnits	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.	metric
priority	priority	The numerical priority assigned to the line item, influencing its serving order against other line items.	metric
requestPlatformTargeting	requestPlatformTargeting	Specifies targeting based on the platform where the ad request originated (e.g., Web, Mobile Web, Mobile Application).	dimension
reservedUnits	reservedUnits	The number of ad units (impressions or clicks) that are reserved by competing line items, impacting availability.	metric
servingEndTime	servingEndTime	The end date and time when an ad or campaign stopped serving.	dimension
startDateTime	startDateTime	The start date and time when an ad or campaign began serving.	dimension
target	customTargeting	Defines the specific ad inventory (e.g., ad units, key-values, geographical locations) that a line item is configured to target for ad delivery.	dimension
unitType	unitType	The type of unit used for pricing or inventory, such as impressions, clicks, or time.	dimension
videoPositionTargeting	videoPositionTargeting	Specifies targeting based on the position of the video ad within video content (e.g., pre-roll, mid-roll, post-roll).	dimension