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_IMPRESSIONSDimension
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_IMPRESSIONSDimension
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_IMPRESSIONSDimension
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_IMPRESSIONSDimension
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_IMPRESSIONSDimension
The number of impressions delivered by an AdSense ad for line item-level dynamic allocation that specifically matched explicit custom criteria targeting.
ADVERTISER_DOMAIN_NAMEDimension
The domain name of the advertiser.
ADVERTISER_IDDimension
The unique identifier of the advertiser.
ADVERTISER_NAMEDimension
The name of the advertiser.
ADVERTISER_VERTICAL_NAMEDimension
The industry vertical or category of the advertiser (e.g., Automotive, Retail).
AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONSMetric
The number of Ad Exchange ad impressions that were eligible to be measured by Active View.
AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONSDimension
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_RATEMetric
The percentage of Ad Exchange Active View measurable impressions that were actually viewable.
AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKSMetric
The number of clicks recorded for Ad Exchange ads at the line item level.
AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONSDimension
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_IMPRESSIONSDimension
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_TIMEMetric
The average duration, in milliseconds, that an ad server impression was viewable according to Active View metrics.
AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONSMetric
The count of ad server impressions for which Active View measurement was possible.
AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONSMetric
The count of ad server impressions that were considered viewable based on Active View standards.
AD_SERVER_ALL_REVENUEMetric
The total revenue generated from all ad impressions served by the ad server.
AD_SERVER_ALL_REVENUE_GROSSMetric
The total gross revenue generated from all ad impressions served by the ad server, before any deductions.
AD_SERVER_CLICKSMetric
The total number of clicks recorded on ads served by the ad server.
AD_SERVER_CPD_REVENUEMetric
The revenue generated from ad server impressions billed on a Cost-Per-Day (CPD) basis.
AD_SERVER_CPM_AND_CPC_REVENUEMetric
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_GROSSMetric
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_CTRMetric
The click-through rate (clicks divided by impressions) for ads served by the ad server.
AD_SERVER_IMPRESSIONSMetric
The total number of ad impressions served by the ad server.
AD_SIZEDimension
The dimensions (width x height) of the ad creative.
AD_TYPE_IDDimension
The unique identifier for the type of ad.
AD_TYPE_NAMEDimension
The name associated with the type of ad.
AD_UNITDimension
The specific ad unit within the inventory hierarchy where the ad was displayed.
AD_UNIT_IDDimension
The unique identifier for the ad unit.
AD_UNIT_NAMEDimension
The name of the ad unit.
BUYER_NETWORK_IDDimension
The unique identifier for the buyer network associated with programmatic ad transactions.
BUYER_NETWORK_NAMEDimension
The name of the buyer network associated with programmatic ad transactions.
CARRIER_NAMEDimension
The name of the mobile carrier network through which the ad was served.
CHANNEL_NAMEDimension
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_CODEDimension
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_IDDimension
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_NAMEDimension
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_IDDimension
The unique identifier for the creative.
CREATIVE_NAMEDimension
The name of the creative.
CREATIVE_SIZEDimension
The dimensions (width x height) of the creative as defined in the system.
CREATIVE_SIZE_DELIVEREDDimension
The actual dimensions (width x height) of the creative that was served.
CREATIVE_TYPEDimension
The type of creative that was served (e.g., image, HTML5, video).
DATEDimension
The specific date for which the report data is aggregated.
DEMAND_CHANNEL_IDMetric
The unique identifier for the demand channel through which the ad impression was generated.
DEMAND_CHANNEL_NAMEDimension
The name of the demand channel through which the ad impression was generated.
DEVICE_CATEGORY_IDDimension
The unique identifier for the category of device used (e.g., desktop, tablet, mobile).
DEVICE_CATEGORY_NAMEDimension
The name of the device category (e.g., Desktop, High-end mobile device, Tablet).
FORECASTED_CREATIVE_RESTRICTIONDimension
Indicates if a creative restriction was applied during the forecast to limit eligible creatives.
FORECASTED_CREATIVE_RESTRICTION_EXCLUDEDDimension
Indicates if a creative restriction was explicitly excluded from the forecast calculation.
LINE_ITEM_COMPUTED_STATUSDimension
The system-determined status of the line item (e.g., active, paused, completed, draft).
LINE_ITEM_COST_TYPEDimension
The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).
LINE_ITEM_CREATIVE_END_DATEDimension
The end date and time when a specific creative associated with a line item is scheduled to stop serving.
LINE_ITEM_CREATIVE_START_DATEDimension
The start date and time when a specific creative associated with a line item is scheduled to begin serving.
LINE_ITEM_DELIVERY_INDICATORMetric
An indicator showing the current pace or status of a line item's delivery.
LINE_ITEM_DELIVERY_PACINGDimension
The method used to distribute the delivery of a line item over its duration (e.g., Evenly, Frontloaded).
LINE_ITEM_END_DATE_TIMEDimension
The date and time when the line item is scheduled to stop serving.
LINE_ITEM_FREQUENCY_CAPDimension
The limit on how many times an individual user can see an ad from this line item within a given period.
LINE_ITEM_GOAL_QUANTITYDimension
The total number of impressions or clicks targeted for delivery by the line item.
LINE_ITEM_IDDimension
The unique identifier for the line item.
LINE_ITEM_LABELSDimension
The labels (categories or attributes) that have been applied to the line item.
LINE_ITEM_NAMEDimension
The name of the line item.
LINE_ITEM_NON_CPD_BOOKED_REVENUEMetric
The booked revenue for line items that are not based on a Cost-Per-Day (CPD) pricing model.
LINE_ITEM_PRIORITYMetric
The numerical priority assigned to the line item, influencing its serving order against other line items.
LINE_ITEM_START_DATE_TIMEDimension
The date and time when the line item is scheduled to begin serving.
LINE_ITEM_TYPEDimension
The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.
MONTH_AND_YEARDimension
The month and year of the ad event.
OPERATING_SYSTEM_VERSION_IDDimension
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_NAMEDimension
The human-readable name of a specific operating system version. This name helps identify and report on ad performance across various OS versions.
ORDER_AGENCYDimension
The advertising agency associated with the order.
ORDER_AGENCY_IDDimension
The unique identifier for the advertising agency associated with the order.
ORDER_END_DATE_TIMEDimension
The date and time when the order is scheduled to conclude.
ORDER_IDDimension
The unique identifier for the order.
ORDER_LABELSDimension
The labels (categories or attributes) that have been applied to the order.
ORDER_NAMEDimension
The name of the order.
ORDER_SALESPERSONDimension
The salesperson responsible for the order.
ORDER_START_DATE_TIMEDimension
The date and time when the order is scheduled to begin.
ORDER_TRAFFICKERDimension
The ad operations professional responsible for implementing and managing the order.
Order TypeDimension
The classification of an order, which is a grouping of line items in Google Ad Manager.
PLACEMENT_IDDimension
The unique identifier for the ad placement.
PLACEMENT_NAMEDimension
The name of the ad placement.
PROGRAMMATIC_CHANNEL_NAMEDimension
The name of the programmatic channel that served the ad.
REGION_CRITERIA_IDDimension
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_NAMEDimension
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_TYPEDimension
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_IDDimension
The unique identifier for the salesperson.
TOTAL_ACTIVE_VIEW_MEASURABLE_IMPRESSIONSMetric
The total number of impressions that were sampled and measured by Active View.
TOTAL_ACTIVE_VIEW_VIEWABLE_IMPRESSIONSMetric
The total number of impressions viewed on the user's screen.
TOTAL_CONVERSIONSMetric
The total number of conversion events recorded across the network.
TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONSMetric
The total number of ad requests that were not filled with an ad across all inventory.
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUEMetric
The total revenue generated from all sources at the line item level.
TOTAL_LINE_ITEM_LEVEL_CLICKSMetric
The total number of clicks generated by line items.
TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUEMetric
The total revenue generated from Cost-Per-Mille (CPM) and Cost-Per-Click (CPC) models at the line item level.
TOTAL_LINE_ITEM_LEVEL_IMPRESSIONSMetric
The total number of impressions recorded for ads at the line item level.
UNIQUE_REACH_IMPRESSIONSDimension
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_SKIPSDimension
The total number of times viewers chose to skip a video ad.
VIDEO_VIEWERSHIP_COMPLETEMetric
Indicates that a video ad was played to 100% completion.
VIDEO_VIEWERSHIP_STARTMetric
Indicates that a video ad began playing.
availableUnitsMetric
The number of ad units (impressions or clicks) that are available for a given line item based on forecasting.
costPerUnitMetric
The cost per unit defined for the line item.
costTypeDimension
The method by which the publisher is paid for the line item (e.g., CPM, CPC, CPD, Flat Rate).
creativePlaceholdersDimension
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.
customFieldsDimension
Custom key-value pairs associated with an entity, providing additional configurable attributes.
deliveredUnitsMetric
The number of ad units (impressions or clicks) that have been successfully delivered for a line item to date.
discountMetric
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.
discountTypeDimension
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.
externalIdDimension
A unique identifier for the entity as recognized by an external system or integrated platform.
forecastEndDateDimension
The end date for the period covered by the forecast.
forecastRunDateDimension
The date on which the inventory forecast was generated.
forecastStartDateDimension
The start date for the period covered by the forecast.
idDimension
The unique system-generated identifier for a specific entity.
lineItemTypeDimension
The classification of the line item, such as Sponsorship, Standard, Network, Bulk, Price Priority, House, or AdSense.
matchedUnitsMetric
The number of ad units (impressions or clicks) that matched the targeting criteria of the line item.
nameDimension
The human-readable name of the entity.
orderAdvertiseridMetric
The unique identifier of the advertiser associated with the order.
orderAdvertisernameDimension
The name of the advertiser associated with the order.
orderAppliedlabelsDimension
The labels (categories or attributes) that have been applied to the order.
orderCustomFieldsDimension
Custom key-value pairs associated with the order, providing additional configurable attributes.
orderCustomfieldsDimension
Custom key-value pairs associated with the order, providing additional configurable attributes.
orderEnddatetimeDimension
The date and time when the order is scheduled to conclude.
orderExternalorderidMetric
The unique identifier for the order as it exists in an external order management system.
orderIdMetric
The unique identifier for the order.
orderNameDimension
The name of the order.
orderPonumberDimension
The purchase order (PO) number associated with the order.
orderStartdatetimeDimension
The date and time when the order is scheduled to begin.
possibleUnitsMetric
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.
priorityMetric
The numerical priority assigned to the line item, influencing its serving order against other line items.
requestPlatformTargetingDimension
Specifies targeting based on the platform where the ad request originated (e.g., Web, Mobile Web, Mobile Application).
reservedUnitsMetric
The number of ad units (impressions or clicks) that are reserved by competing line items, impacting availability.
servingEndTimeDimension
The end date and time when an ad or campaign stopped serving.
startDateTimeDimension
The start date and time when an ad or campaign began serving.
targetcustomTargetingDimension
Defines the specific ad inventory (e.g., ad units, key-values, geographical locations) that a line item is configured to target for ad delivery.
unitTypeDimension
The type of unit used for pricing or inventory, such as impressions, clicks, or time.
videoPositionTargetingDimension
Specifies targeting based on the position of the video ad within video content (e.g., pre-roll, mid-roll, post-roll).