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 |
|---|---|---|---|
ADVERTISER_ID |
ADVERTISER_ID |
The unique identifier of the advertiser. |
dimension |
ADVERTISER_NAME |
ADVERTISER_NAME |
The name of the advertiser. |
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_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 |
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 |
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 |
DATE |
DATE |
The specific date for which the report data is aggregated. |
dimension |
DEMAND_CHANNEL_ID |
DEMAND_CHANNEL_ID |
Breaks down reporting data by demand channels, identified by their unique ID. |
metric |
DEMAND_CHANNEL_NAME |
DEMAND_CHANNEL_NAME |
Breaks down reporting data by the name of the demand channel. |
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_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 |
Represents the end date for a creative associated with a line item. This date indicates when the creative will stop serving as part of the line item’s campaign. The date is without time information. |
dimension |
LINE_ITEM_CREATIVE_START_DATE |
LINE_ITEM_CREATIVE_START_DATE |
Represents the start date for a creative associated with a line item. This date indicates when the creative will begin serving as part of the line item’s campaign. The date is without time information. |
dimension |
LINE_ITEM_DELIVERY_INDICATOR |
LINE_ITEM_DELIVERY_INDICATOR |
An indicator showing the current pace or status of a line item’s delivery. |
dimension |
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 |
MONTH_AND_YEAR |
MONTH_AND_YEAR |
Breaks down reporting data by month and year in the network time zone. |
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 |
PROGRAMMATIC_CHANNEL_NAME |
PROGRAMMATIC_CHANNEL_NAME |
The name of the programmatic channel through which the ad was transacted (e.g., Open Auction, Private Auction, Preferred Deal). |
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_LINE_ITEM_LEVEL_ALL_REVENUE |
TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE |
The total revenue generated by ad servers, including CPM, CPC, and CPD revenue, with line item-level dynamic allocation. |
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 by ad servers from CPM (Cost Per Mille/Thousand) and CPC (Cost Per Click) ads, including line item-level dynamic allocation. |
metric |
VIDEO_INTERACTION_VIDEO_SKIPS |
VIDEO_INTERACTION_VIDEO_SKIPS |
The total number of times viewers chose to skip a video ad. |
dimension |
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 |
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 |
Represents a discount applied to a line item, which can be either a percentage or an absolute value, depending on the line item’s discount type. |
metric |
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 |