# type ReportQuery (v202602)

**Service** **ReportService** **Dependencies** [ReportJob](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportJob) [SavedQuery](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.SavedQuery) ▼ **ReportQuery**

A `ReportQuery` object allows you to specify the selection criteria for
generating a report. Only reports with at least one [Column](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column) are supported.

*** ** * ** ***

Namespace
:
    `https://www.google.com/apis/ads/publisher/v202602`

| ## Field ||
|---|---|
| ### `dimensions` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension[]` The list of break-down types being requested in the report. The generated report will contain the dimensions in the same order as requested. This field is required. *** ** * ** *** **Enumerations** `MONTH_AND_YEAR` :   Breaks down reporting data by month and year in the network time zone. Can be used to filter on month using ISO 4601 format 'YYYY-MM'. Corresponds to "Month and year" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Partner finance, YouTube consolidated. `WEEK` :   Breaks down reporting data by week of the year in the network time zone. Cannot be used for filtering. Corresponds to "Week" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, YouTube consolidated. `DATE` :   Breaks down reporting data by date in the network time zone. Can be used to filter by date using ISO 8601's format 'YYYY-MM-DD'". Corresponds to "Date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video, YouTube consolidated. `DAY` :   Breaks down reporting data by day of the week in the network time zone. Can be used to filter by day of the week using the index of the day (from 1 for Monday is 1 to 7 for Sunday). Corresponds to "Day of week" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, YouTube consolidated. `HOUR` :   Breaks down reporting data by hour of the day in the network time zone. Can be used to filter by hour of the day (from 0 to 23). Corresponds to "Hour" in the Ad Manager UI. Compatible with any of the following report types: Historical, Real-time video. `DATE_PT` :   Breaks down reporting data by date in the PT time zone. Can be used to filter by date using ISO 8601's format 'YYYY-MM-DD'". Can only be used when time zone type is PACIFIC. Compatible with the "Historical" report type. `WEEK_PT` :   Breaks down reporting data by week of the year in the PT time zone. Cannot be used for filtering. Can only be used when time zone type is PACIFIC. Compatible with the "Historical" report type. `MONTH_YEAR_PT` :   Breaks down reporting data by month and year in the PT time zone. Can be used to filter on month using ISO 4601 format 'YYYY-MM'. Can only be used when time zone type is PACIFIC. Compatible with the "Historical" report type. `DAY_OF_WEEK_PT` :   Breaks down reporting data by day of the week in the PT time zone. Can be used to filter by day of the week using the index of the day (from 1 for Monday is 1 to 7 for Sunday). Can only be used when time zone type is PACIFIC. Compatible with the "Historical" report type. `LINE_ITEM_ID` :   Breaks down reporting data by [LineItem.id](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#id). Can be used to filter by [LineItem.id](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#id). Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_NAME` :   Breaks down reporting data by line item. [LineItem.name](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#name) and [LineItem.id](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#id) are automatically included as columns in the report. Can be used to filter by [LineItem.name](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#name). Corresponds to "Line item" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_TYPE` :   Breaks down reporting data by [LineItem.lineItemType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#lineItemType). Can be used to filter by line item type using [LineItemType](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.LineItemType) enumeration names. Corresponds to "Line item type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `ORDER_ID` :   Breaks down reporting data by [Order.id](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#id). Can be used to filter by [Order.id](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#id). Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_NAME` :   Breaks down reporting data by order. [Order.name](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#name) and [Order.id](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#id) are automatically included as columns in the report. Can be used to filter by [Order.name](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#name). Corresponds to "Order" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_DELIVERY_STATUS` :   Delivery status of the order. Not available as a dimension to report on, but exists as a dimension in order to filter on it using PQL. Valid values are 'STARTED', 'NOT_STARTED' and 'COMPLETED'. Compatible with the "Historical" report type. `ADVERTISER_ID` :   Breaks down reporting data by advertising company [Company.id](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#id). Can be used to filter by [Company.id](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#id). Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ADVERTISER_NAME` :   Breaks down reporting data by advertising company. [Company.name](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#name) and [Company.id](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#id) are automatically included as columns in the report. Can be used to filter by [Company.name](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#name). Corresponds to "Advertiser" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `AD_NETWORK_ID` :   The network that provided the ad for SDK ad mediation. If selected for a report, that report will include only SDK mediation ads and will not contain non-SDK mediation ads. SDK mediation ads are ads for mobile devices. They have a list of ad networks which can provide ads to serve. Not every ad network will have an ad to serve so the device will try each network one-by-one until it finds an ad network with an ad to serve. The ad network that ends up serving the ad will appear here. Note that this id does not correlate to anything in the companies table and is not the same id as is served by [ADVERTISER_ID](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#ADVERTISER_ID). Compatible with the "Historical" report type. `AD_NETWORK_NAME` :   The name of the network defined in [AD_NETWORK_ID](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#AD_NETWORK_ID). Corresponds to "Ad network name" in the Ad Manager UI. Compatible with the "Historical" report type. `SALESPERSON_ID` :   Breaks down reporting data by salesperson [User.id](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User#id). Can be used to filter by [User.id](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User#id). Compatible with any of the following report types: Historical, Future sell-through, Reach. `SALESPERSON_NAME` :   Breaks down reporting data by salesperson. [User.name](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User#name) and [User.id](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User#id) of the salesperson are automatically included as columns in the report. Can be used to filter by [User.name](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User#name). Corresponds to "Salesperson" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach. `CREATIVE_ID` :   Breaks down reporting data by [Creative.id](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#id) or creative set id (master's [Creative.id](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#id)) if the creative is part of a creative set. Can be used to filter by [Creative.id](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#id). Compatible with any of the following report types: Historical, Ad speed, Real-time video. `CREATIVE_NAME` :   Breaks down reporting data by creative. [Creative.name](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#name) and [Creative.id](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#id) are automatically included as columns in the report. Can be used to filter by [Creative.name](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#name). Corresponds to "Creative" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed, Real-time video. `CREATIVE_TYPE` :   Breaks down reporting data by creative type. Corresponds to "Creative type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `CREATIVE_BILLING_TYPE` :   Breaks down reporting data by creative billing type. Corresponds to "Creative billing type" in the Ad Manager UI. Compatible with the "Historical" report type. `CUSTOM_EVENT_ID` :   Breaks down reporting data by custom event ID. Compatible with the "Historical" report type. `CUSTOM_EVENT_NAME` :   Breaks down reporting data by custom event name. Corresponds to "Custom event" in the Ad Manager UI. Compatible with the "Historical" report type. `CUSTOM_EVENT_TYPE` :   Breaks down reporting data by custom event type (timer/exit/counter). Corresponds to "Custom event type" in the Ad Manager UI. Compatible with the "Historical" report type. `CREATIVE_SIZE` :   Breaks down reporting data by [Creative.size](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#size). Cannot be used for filtering. Corresponds to "Creative size" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_UNIT_ID` :   Breaks down reporting data by [AdUnit.id](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#id). Can be used to filter by [AdUnit.id](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#id). [AD_UNIT_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#AD_UNIT_NAME), i.e. [AdUnit.name](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#name), is automatically included as a dimension in the report. Compatible with any of the following report types: Historical, Future sell-through, Ad speed, Real-time video. `AD_UNIT_NAME` :   Breaks down reporting data by ad unit. [AdUnit.name](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#name) and [AdUnit.id](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#id) are automatically included as columns in the report. Can be used to filter by [AdUnit.name](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#name). Corresponds to "Ad unit" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Ad speed, Real-time video. `PARENT_AD_UNIT_ID` :   Used to filter on all the descendants of an ad unit by [AdUnit.id](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#id). Not available as a dimension to report on. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `PARENT_AD_UNIT_NAME` :   Used to filter on all the descendants of an ad unit by [AdUnit.name](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#name). Not available as a dimension to report on. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `PLACEMENT_ID` :   Breaks down reporting data by [Placement.id](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#id). Can be used to filter by [Placement.id](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#id). Compatible with any of the following report types: Historical, Future sell-through, Reach. `PLACEMENT_NAME` :   Breaks down reporting data by placement. [Placement.name](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#name) and [Placement.id](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#id) are automatically included as columns in the report. Can be used to filter by [Placement.name](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#name). Corresponds to "Placement" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach. `PLACEMENT_STATUS` :   Status of the placement. Not available as a dimension to report on, but exists as a dimension in order to filter on it using PQL. Can be used to filter on [Placement.status](https://developers.google.com/ad-manager/api/reference/v202602/PlacementService.Placement#status) by using [InventoryStatus](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.InventoryStatus) enumeration names. Compatible with any of the following report types: Historical, Future sell-through. `TARGETING` :   Breaks down reporting data by criteria predefined by Ad Manager like the operating system, browser etc. Cannot be used for filtering. Corresponds to "Targeting" in the Ad Manager UI. Compatible with the "Historical" report type. `BROWSER_NAME` :   Breaks down reporting data by browser criteria predefined by Ad Manager. Corresponds to "Browser" in the Ad Manager UI. Compatible with the "Historical" report type. `DEVICE_CATEGORY_ID` :   The ID of the device category to which an ad is being targeted. Can be used to filter by device category ID. Compatible with any of the following report types: Historical, Ad speed, Real-time video. `DEVICE_CATEGORY_NAME` :   The category of device (smartphone, feature phone, tablet, or desktop) to which an ad is being targeted. Can be used to filter by device category name. Corresponds to "Device category" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed, Real-time video. `COUNTRY_CRITERIA_ID` :   Breaks down reporting data by country criteria ID. Can be used to filter by country criteria ID. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, YouTube consolidated. `COUNTRY_CODE` :   Breaks down reporting data by country code. Compatible with the "Historical" report type. `COUNTRY_NAME` :   Breaks down reporting data by country name. The country name and the country criteria ID are automatically included as columns in the report. Can be used to filter by country name using the US English name. Corresponds to "Country" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, YouTube consolidated. `REGION_CRITERIA_ID` :   Breaks down reporting data by region criteria ID. Can be used to filter by region criteria ID. Compatible with the "Historical" report type. `REGION_NAME` :   Breaks down reporting data by region name. The region name and the region criteria ID are automatically included as columns in the report. Can be used to filter by region name using the US English name. Corresponds to "Region" in the Ad Manager UI. Compatible with the "Historical" report type. `CITY_CRITERIA_ID` :   Breaks down reporting data by city criteria ID. Can be used to filter by city criteria ID. Compatible with the "Historical" report type. `CITY_NAME` :   Breaks down reporting data by city name. The city name and the city criteria ID are automatically included as columns in the report. Can be used to filter by city name using the US English name. Corresponds to "City" in the Ad Manager UI. Compatible with the "Historical" report type. `METRO_CRITERIA_ID` :   Breaks down reporting data by metro criteria ID. Can be used to filter by metro criteria ID. Compatible with the "Historical" report type. `METRO_NAME` :   Breaks down reporting data by metro name. The metro name and the metro criteria ID are automatically included as columns in the report. Can be used to filter by metro name using the US English name. Corresponds to "Metro" in the Ad Manager UI. Compatible with the "Historical" report type. `POSTAL_CODE_CRITERIA_ID` :   Breaks down reporting data by postal code criteria ID. Can be used to filter by postal code criteria ID. Compatible with the "Historical" report type. `POSTAL_CODE` :   Breaks down reporting data by postal code. The postal code and the postal code criteria ID are automatically included as columns in the report. Can be used to filter by postal code. Corresponds to "Postal code" in the Ad Manager UI. Compatible with the "Historical" report type. `CUSTOM_TARGETING_VALUE_ID` :   Breaks down reporting data by [CustomTargetingValue.id](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue#id). Can be used to filter by [CustomTargetingValue.id](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue#id). Compatible with the "Historical" report type. `CUSTOM_CRITERIA` : Breaks down reporting data by custom criteria. The [CustomTargetingValue](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue) is displayed in the form: - car=honda when value match type is [CustomTargetingValue.MatchType.EXACT](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue.MatchType#EXACT) - car\~honda when value match type is [CustomTargetingValue.MatchType.BROAD](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue.MatchType#BROAD) - car=\*honda when value match type is [CustomTargetingValue.MatchType.PREFIX](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue.MatchType#PREFIX) - car\~\*honda when value match type is [CustomTargetingValue.MatchType.BROAD_PREFIX](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue.MatchType#BROAD_PREFIX) [CUSTOM_TARGETING_VALUE_ID](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#CUSTOM_TARGETING_VALUE_ID), i.e. [CustomTargetingValue.id](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue#id) is automatically included as a column in the report. Cannot be used for filtering; use [CUSTOM_TARGETING_VALUE_ID](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#CUSTOM_TARGETING_VALUE_ID) instead. When using this `Dimension`, metrics for freeform key values are only reported on when they are registered with `CustomTargetingService`. Corresponds to "Key-values" in the Ad Manager UI. Compatible with the "Historical" report type. `CONTENT_ID` :   Breaks down reporting data by [Content.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#id). Can be used to filter by [Content.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#id). Compatible with any of the following report types: Historical, Future sell-through, YouTube consolidated. `CONTENT_NAME` :   Breaks down reporting data by content. [Content.name](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#name) and [Content.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#id) are automatically included as columns in the report. Can be used to filter by [Content.name](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#name). Corresponds to "Content" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, YouTube consolidated. `CONTENT_BUNDLE_ID` :   Breaks down reporting data by [ContentBundle.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentBundleService.ContentBundle#id). Can be used to filter by [ContentBundle.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentBundleService.ContentBundle#id). Compatible with any of the following report types: Historical, Future sell-through, YouTube consolidated. `CONTENT_BUNDLE_NAME` :   Breaks down reporting data by content bundle. [ContentBundle.name](https://developers.google.com/ad-manager/api/reference/v202602/ContentBundleService.ContentBundle#name) and [ContentBundle.id](https://developers.google.com/ad-manager/api/reference/v202602/ContentBundleService.ContentBundle#id) are automatically included as columns in the report. Can be used to filter by [ContentBundle.name](https://developers.google.com/ad-manager/api/reference/v202602/ContentBundleService.ContentBundle#name). Corresponds to "Content bundle" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, YouTube consolidated. `CMS_METADATA` : Breaks down reporting data by CMS metadata. To use this dimension in API, a list of cms metadata key IDs must be specified in [ReportQuery.cmsMetadataKeyIds](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#cmsMetadataKeyIds). This dimension can be used as a filter in the [Statement](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Statement) in PQL syntax: CMS_METADATA_KEY\[keyId\]_ID = [CMS metadata value ID](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataValue#cmsMetadataValueId) For example: WHERE CMS_METADATA_KEY\[4242\]_ID = 53423 `VIDEO_FALLBACK_POSITION` :   Breaks down reporting data by the fallback position of the video ad, i.e., `NON_FALLBACK`, `FALLBACK_POSITION_1`, `FALLBACK_POSITION_2`, etc. Can be used for filtering. Corresponds to "Fallback position" in the Ad Manager UI. Compatible with the "Historical" report type. `POSITION_OF_POD` :   Breaks down reporting data by the position of the video ad within the video stream, i.e., `UNKNOWN_POSITION`, `PREROLL`, `POSTROLL`, `UNKNOWN_MIDROLL`, `MIDROLL_1`, `MIDROLL_2`, etc. `UNKNOWN_MIDROLL` represents a midroll, but which specific midroll is unknown. Can be used for filtering. Corresponds to "Position of pod" in the Ad Manager UI. Compatible with any of the following report types: Historical, Real-time video. `POSITION_IN_POD` :   Breaks down reporting data by the position of the video ad within the pod, i.e., `UNKNOWN_POSITION`, `POSITION_1`, `POSITION_2`, etc. Can be used for filtering. Corresponds to "Position in pod" in the Ad Manager UI. Compatible with the "Historical" report type. `CUSTOM_SPOT_ID` :   Breaks down reporting data by [AdSpot.id](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.AdSpot#id). Can be used to filter by [AdSpot.id](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.AdSpot#id). Compatible with the "Historical" report type. `CUSTOM_SPOT_NAME` :   Breaks down reporting data by content. [AdSpot.name](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.AdSpot#name) and [AdSpot.id](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.AdSpot#id) are automatically included as columns in the report. Can be used to filter by [AdSpot.name](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.AdSpot#name). Corresponds to "Custom spot" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_REDIRECT_THIRD_PARTY` :   Breaks down reporting data by video redirect vendor. Corresponds to "Video redirect third party" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_BREAK_TYPE` :   The filter to break down reporting data by video break type. Not available as a dimension to report on. Compatible with the "Historical" report type. `VIDEO_BREAK_TYPE_NAME` :   The filter to break down reporting data by video break type. Can only be used with the following string values: "Unknown", "Single ad video request", "Optimized pod video request". Not available as a dimension to report on. Compatible with the "Historical" report type. `VIDEO_VAST_VERSION` :   Breaks down reporting data by vast version type name. Corresponds to "VAST version" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_AD_REQUEST_DURATION_ID` :   Breaks down reporting data by video request duration bucket. Compatible with the "Historical" report type. `VIDEO_AD_REQUEST_DURATION` :   Breaks down reporting data by video request duration bucket name. Corresponds to "Video ad request duration" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_PLCMT_ID` :   Breaks down reporting data by the ID of the type of video placement as defined by the updated IAB definition. The values of "in-stream" and "accompanying content" are declared via publisher inputted URL parameters. The values of "interstitial" and "no content" are populated automatically based on the declared inventory type. The video placement dimension only applies to backfill traffic. `VIDEO_PLCMT_NAME` :   Breaks down reporting data by the name of the type of video placement as defined by the updated IAB definition. The values of "in-stream" and "accompanying content" are declared via publisher inputted URL parameters. The values of "interstitial" and "no content" are populated automatically based on the declared inventory type. The video placement dimension only applies to backfill traffic. Corresponds to "Video placement (new)" in the Ad Manager UI. Compatible with the "Historical" report type. `INVENTORY_FORMAT` :   Breaks down impressions by inventory format id. Compatible with the "Historical" report type. `INVENTORY_FORMAT_NAME` :   Breaks down impressions by inventory format name. Corresponds to "Inventory format" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_PARTNER_ID` :   Breaks down reporting data by partner [Company.id](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#id). Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_PARTNER_NAME` :   Breaks down reporting data by partner [Company.name](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#name) and [Company.id](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#id) are automatically included as columns in the report. Corresponds to "Partner management partner" in the Ad Manager UI. Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_PARTNER_LABEL_ID` :   Breaks down reporting data by partner label [Label.id](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#id). Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_PARTNER_LABEL_NAME` :   Breaks down reporting data by partner label. [Label.name](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#name) and [Label.id](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#id) are automatically included as columns in the report. Corresponds to "Partner label" in the Ad Manager UI. Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_ASSIGNMENT_ID` :   Breaks down reporting data by partner assignment id. Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_ASSIGNMENT_NAME` :   Breaks down reporting data by partner assignment name. PartnerAssignment name and id are automatically included as columns in the report. Corresponds to "Partner management assignment" in the Ad Manager UI. Compatible with any of the following report types: Historical, Partner finance. `INVENTORY_SHARE_ASSIGNMENT_ID` :   Breaks down reporting data by inventory sharing assignment ID. Compatible with the "Historical" report type. `INVENTORY_SHARE_ASSIGNMENT_NAME` :   Breaks down reporting data by inventory sharing assignment name. Corresponds to "Inventory share assignment" in the Ad Manager UI. Compatible with the "Historical" report type. `INVENTORY_SHARE_OUTCOME` :   Breaks down reporting data by inventory sharing outcome. Corresponds to "Inventory share outcome" in the Ad Manager UI. Compatible with the "Historical" report type. `GRP_DEMOGRAPHICS` : Breaks down reporting data by gender and age group, i.e., MALE_13_TO_17, MALE_18_TO_24, MALE_25_TO_34, MALE_35_TO_44, MALE_45_TO_54, MALE_55_TO_64, MALE_65_PLUS, FEMALE_13_TO_17, FEMALE_18_TO_24, FEMALE_25_TO_34, FEMALE_35_TO_44, FEMALE_45_TO_54, FEMALE_55_TO_64, FEMALE_65_PLUS, UNKNOWN_0_TO_17 and UNKNOWN. Whenever this dimension is selected, [COUNTRY_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#COUNTRY_NAME) must be selected. This dimension is supported only for GRP columns. Can correspond to any of the following in the Ad Manager UI: Demographics, comScore vCE demographics. Compatible with the "Reach" report type. `AD_REQUEST_AD_UNIT_SIZES` :   Breaks down reporting data by the ad unit sizes specified in ad requests. Formatted as comma separated values, e.g. "300x250,300x250v,300x60". This dimension is supported only for sell-through columns. Corresponds to "Ad request sizes" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `AD_REQUEST_CUSTOM_CRITERIA` :   Breaks down reporting data by the custom criteria specified in ad requests. Formatted as comma separated [key](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingKey)-[values](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue), where a key-value is formatted as `key1=value_1|...|value_n,key2=value_1|...|value_n,...`. This dimension is supported only for sell-through columns. Corresponds to "Key-values" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `IS_FIRST_LOOK_DEAL` :   Break down the report by a boolean indicator. It's TRUE for Ad Exchange traffic fulfilled by First Look Deals. It can be used both as a dimension or dimension filter. As a filter, it can only be used with the string values "true" and "false". Corresponds to "Is First Look" in the Ad Manager UI. Compatible with the "Historical" report type. `IS_ADX_DIRECT` :   Break down the report by a boolean indicator. It's TRUE for AdX Direct traffic. It can be used both as a dimension or dimension filter. As a filter, it can only be used with the string values "true" and "false". Corresponds to "Is AdX Direct" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_ID` :   Breaks down reporting data by yield group ID. Compatible with the "Historical" report type. `YIELD_GROUP_NAME` :   Breaks down reporting data by yield group name. Corresponds to "Yield group" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_PARTNER` :   Breaks down reporting data by yield partner. Corresponds to "Yield partner" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_PARTNER_TAG` :   Breaks down reporting data by the tag of a yield partner in a yield group. Corresponds to "Yield partner tag" in the Ad Manager UI. Compatible with the "Historical" report type. `EXCHANGE_BIDDING_DEAL_ID` :   The ID of an exchange bidding deal. Corresponds to "Exchange bidding deal id" in the Ad Manager UI. Compatible with the "Historical" report type. `EXCHANGE_BIDDING_DEAL_TYPE` :   The type of an exchange bidding deal. Corresponds to "Exchange bidding deal type" in the Ad Manager UI. Compatible with the "Historical" report type. `CLASSIFIED_ADVERTISER_ID` :   The ID of a classified advertiser. Compatible with the "Ad speed" report type. `CLASSIFIED_ADVERTISER_NAME` :   The name of a classified advertiser. Corresponds to "Advertiser (classified)" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `CLASSIFIED_BRAND_ID` :   The ID of a classified brand. Compatible with the "Ad speed" report type. `CLASSIFIED_BRAND_NAME` :   The name of a classified brand. Corresponds to "Brand (classified)" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `MEDIATION_TYPE` :   Breaks down reporting data by mediation type. A mediation type can be web, mobile app or video. Corresponds to "Mediation type" in the Ad Manager UI. Compatible with the "Historical" report type. `NATIVE_TEMPLATE_ID` :   Breaks down reporting data by native template (also known as creative template) ID. Compatible with the "Historical" report type. `NATIVE_TEMPLATE_NAME` :   Breaks down reporting data by native template (also known as creative template) name. Corresponds to "Native ad format name" in the Ad Manager UI. Compatible with the "Historical" report type. `NATIVE_STYLE_ID` :   Breaks down reporting data by native style ID. Compatible with the "Historical" report type. `NATIVE_STYLE_NAME` :   Breaks down reporting data by native style name. Corresponds to "Native style name" in the Ad Manager UI. Compatible with the "Historical" report type. `CHILD_NETWORK_CODE` :   Breaks down reporting data by child network code in MCM "Manage Inventory". **This dimension only works for MCM "Manage Inventory" parent publishers.** Corresponds to "Child network code" in the Ad Manager UI. Compatible with the "Historical" report type. `MOBILE_APP_RESOLVED_ID` :   Breaks down reporting data by mobile app ID received in the ad request (which may be made up). If app ID is not available, '(Not applicable)' will be returned. Special values like 'null' and 'unidentified' will be reported as '(Not applicable)'. Can be used for filtering. Corresponds to "App ID" in the Ad Manager UI. Compatible with the "Historical" report type. `MOBILE_APP_NAME` :   Breaks down reporting data by mobile app name. Can be used for filtering. Corresponds to "App names" in the Ad Manager UI. Compatible with the "Historical" report type. `MOBILE_DEVICE_NAME` :   Breaks down reporting data by device name. Can be used for filtering. Corresponds to "Devices" in the Ad Manager UI. Compatible with the "Historical" report type. `MOBILE_INVENTORY_TYPE` :   Breaks down reporting data by inventory type. Can be used for filtering. Corresponds to "Inventory types" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `OPERATING_SYSTEM_VERSION_ID` :   Breaks down reporting data by OS version id. Compatible with the "Historical" report type. `OPERATING_SYSTEM_VERSION_NAME` :   Breaks down reporting data by OS version name. Corresponds to "Operating system" in the Ad Manager UI. Compatible with the "Historical" report type. `REQUEST_TYPE` :   Breaks down reporting data by request type. Can be used for filtering. Corresponds to "Request type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `AD_UNIT_STATUS` :   Status of the ad unit. Not available as a dimension to report on, but exists as a dimension in order to filter on it using PQL. Valid values correspond to [InventoryStatus](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.InventoryStatus). Compatible with any of the following report types: Historical, Future sell-through, Ad speed, Real-time video. `MASTER_COMPANION_CREATIVE_ID` :   Breaks down reporting data by [Creative.id](https://developers.google.com/ad-manager/api/reference/v202602/CreativeService.Creative#id). This includes regular creatives, and master and companions in case of creative sets. Compatible with the "Historical" report type. `MASTER_COMPANION_CREATIVE_NAME` :   Breaks down reporting data by creative. This includes regular creatives, and master and companions in case of creative sets. Corresponds to "Master and Companion creative" in the Ad Manager UI. Compatible with the "Historical" report type. `AUDIENCE_SEGMENT_ID` :   Breaks down reporting data by billable audience segment ID. Compatible with the "Historical" report type. `AUDIENCE_SEGMENT_NAME` :   Breaks down reporting data by billable audience segment name. Corresponds to "Audience segment (billable)" in the Ad Manager UI. Compatible with the "Historical" report type. `AUDIENCE_SEGMENT_DATA_PROVIDER_NAME` :   Breaks down reporting data by audience segment data provider name. Corresponds to "Data partner" in the Ad Manager UI. Compatible with the "Historical" report type. `WEB_PROPERTY_CODE` :   Breaks down data by web property code. Compatible with the "Historical" report type. `BUYING_AGENCY_NAME` :   Breaks down reporting data by agency. Corresponds to "Buying agency" in the Ad Manager UI. Compatible with the "Historical" report type. `BUYER_NETWORK_ID` :   Breaks down reporting data by buyer network Id. Compatible with the "Historical" report type. `BUYER_NETWORK_NAME` :   Breaks down reporting data by buyer network name. Corresponds to "Buyer network" in the Ad Manager UI. Compatible with the "Historical" report type. `BIDDER_ID` :   Breaks down reporting data by Bidder ID. Compatible with the "Historical" report type. `BIDDER_NAME` :   Breaks down reporting data by Bidder name. Corresponds to "Bidder" in the Ad Manager UI. Compatible with the "Historical" report type. `ADVERTISER_DOMAIN_NAME` :   Breaks down reporting data by advertiser domain. Corresponds to "Advertiser domain" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_OPTIMIZATION_TYPE` :   Breaks down reporting data by optimization type. Corresponds to "Optimization type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ADVERTISER_VERTICAL_NAME` :   Breaks down reporting data by advertiser vertical. Corresponds to "Advertiser vertical" in the Ad Manager UI. Compatible with the "Historical" report type. `NIELSEN_SEGMENT` :   Campaign date segment of Nielsen Digital Ad Ratings reporting. Corresponds to "Nielsen Digital Ad Ratings segment" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_DEMOGRAPHICS` :   Breaks down reporting data by gender and age group, i.e., MALE_18_TO_20, MALE_21_TO_24, MALE_25_TO_29, MALE_30_TO_35, MALE_35_TO_39, MALE_40_TO_44, MALE_45_TO_49, MALE_50_TO_54, MALE_55_TO_64, MALE_65_PLUS, FEMALE_18_TO_20, FEMALE_21_TO_24, FEMALE_25_TO_29, FEMALE_30_TO_34, FEMALE_35_TO_39, FEMALE_40_TO_44, FEMALE_45_TO_49, FEMALE_50_TO_54, FEMALE_55_TO_64, FEMALE_65_PLUS, and OTHER. `NIELSEN_RESTATEMENT_DATE` :   Data restatement date of Nielsen Digital Ad Ratings data. Corresponds to "Nielsen Digital Ad Ratings restatement date" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_DEVICE_ID` :   Breaks down reporting data by device type, i.e., Computer, Mobile and other types. This dimension is supported only for Nielsen columns. Compatible with the "Reach" report type. `NIELSEN_DEVICE_NAME` :   Breaks down reporting data by device type, i.e., Computer, Mobile and other types. This dimension is supported only for Nielsen columns. Corresponds to "Nielsen Digital Ad Ratings device" in the Ad Manager UI. Compatible with the "Reach" report type. `PROGRAMMATIC_BUYER_ID` :   Breaks down reporting data by [ProposalMarketplaceInfo.buyerAccountId](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalMarketplaceInfo#buyerAccountId). Compatible with any of the following report types: Historical, Reach. `PROGRAMMATIC_BUYER_NAME` :   Breaks down reporting data by programmatic buyer name. Corresponds to "Deal buyer" in the Ad Manager UI. Compatible with the "Historical" report type. `REQUESTED_AD_SIZES` :   Breaks down reporting data by requested ad size(s). This can be a chain of sizes or a single size. Corresponds to "Requested ad sizes" in the Ad Manager UI. Compatible with the "Historical" report type. `CREATIVE_SIZE_DELIVERED` :   Breaks down reporting data by the creative size the ad was delivered to. Corresponds to "Creative size (delivered)" in the Ad Manager UI. Compatible with any of the following report types: Historical, Ad speed. `PROGRAMMATIC_CHANNEL_ID` :   Breaks down reporting data by the type of transaction that occurred in Ad Exchange. Compatible with the "Historical" report type. `PROGRAMMATIC_CHANNEL_NAME` :   Breaks down reporting data by the type of transaction that occurred in Ad Exchange. Corresponds to "Programmatic channel" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `CLASSIFIED_YIELD_PARTNER_NAME` :   Breaks down data by detected yield partner name. Corresponds to "Yield partner (classified)" in the Ad Manager UI. Compatible with the "Historical" report type. `DP_DATE` :   Breaks down Demand reporting data by date in the network time zone. Can be used to filter by date using ISO 8601's format 'YYYY-MM-DD'". Corresponds to "Date" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_WEEK` :   Breaks down Demand reporting data by week of the year in the network time zone. Cannot be used for filtering. Corresponds to "Week" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_MONTH_YEAR` :   Breaks down Demand reporting data by month and year in the network time zone. Cannot be used to filter. Corresponds to "Month and year" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_COUNTRY_CRITERIA_ID` :   Breaks down Demand reporting data by country criteria ID. Can be used to filter by country criteria ID. Compatible with the "Ad Connector" report type. `DP_COUNTRY_NAME` :   Breaks down Demand reporting data by country name. The country name and the country criteria ID are automatically included as columns in the report. Can be used to filter by country name using the US English name. Corresponds to "Country" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_INVENTORY_TYPE` :   Breaks down Demand reporting data by inventory type. Corresponds to "Inventory type" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_CREATIVE_SIZE` :   Breaks down Demand reporting data by the creative size the ad was delivered to. Corresponds to "Creative size" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_BRAND_NAME` :   Breaks down Demand reporting data by the brand name that bids on ads. Corresponds to "Brand" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ADVERTISER_NAME` :   Breaks down Demand reporting data by the advertiser name that bid on ads. Corresponds to "Advertiser" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ADX_BUYER_NETWORK_NAME` :   Breaks down Demand reporting data by Ad Exchange ad network name. Example: Google Adwords. Corresponds to "Buyer network" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_MOBILE_DEVICE_NAME` :   Breaks down reporting data by device name. Corresponds to "Device" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_DEVICE_CATEGORY_NAME` :   Breaks down reporting data by the category of device (smartphone, feature phone, tablet, or desktop). Corresponds to "Device category" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_TAG_ID` :   Breaks down reporting data by the tag id provided by the publisher in the ad request. Corresponds to "Tag ID" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_DEAL_ID` :   Breaks down reporting data by the deal id provided by the publisher in the ad request. Corresponds to "Deal IDs" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_APP_ID` :   Breaks down reporting data by mobile app ID. Corresponds to "App ID" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `CUSTOM_DIMENSION` :   Breaks down reporting data by the [CustomTargetingKey](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingKey)s marked as dimensions in inventory key-values setup. To use this dimension, a list of custom targeting key IDs must be specified in [ReportQuery.customDimensionKeyIds](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#customDimensionKeyIds). `DEMAND_CHANNEL_ID` :   Breaks down reporting data by demand channels. Compatible with any of the following report types: Historical, Reach, Ad speed. `DEMAND_CHANNEL_NAME` :   Breaks down reporting data by demand channel name. Corresponds to "Demand channel" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach, Ad speed. `DOMAIN` :   Breaks down reporting data by top private domain. Corresponds to "Domain" in the Ad Manager UI. Compatible with the "Historical" report type. `SERVING_RESTRICTION_ID` :   Breaks down reporting data by serving restriction id. Compatible with the "Historical" report type. `SERVING_RESTRICTION_NAME` :   Breaks down reporting data by serving restriction name. Corresponds to "Serving restriction" in the Ad Manager UI. Compatible with the "Historical" report type. `UNIFIED_PRICING_RULE_ID` :   Breaks down reporting data by pricing rule id. Compatible with the "Historical" report type. `UNIFIED_PRICING_RULE_NAME` :   Breaks down reporting data by pricing rule name. Corresponds to "Pricing rule" in the Ad Manager UI. Compatible with the "Historical" report type. `FIRST_LOOK_PRICING_RULE_ID` :   Breaks down reporting data by first price pricing rule id. Compatible with the "Historical" report type. `FIRST_LOOK_PRICING_RULE_NAME` :   Breaks down reporting data by first price pricing rule name. Corresponds to "First look pricing rule" in the Ad Manager UI. Compatible with the "Historical" report type. `BID_RANGE` :   Breaks down reporting data by the range within which the bid falls, divided into $0.10 buckets. Corresponds to "Bid range" in the Ad Manager UI. Compatible with the "Historical" report type. `BID_REJECTION_REASON` :   Breaks down reporting data by the ID of the reason the bid lost or did not participate in the auction. Compatible with the "Historical" report type. `BID_REJECTION_REASON_NAME` :   Breaks down reporting data by the reason the bid lost or did not participate in the auction. Corresponds to "Bid rejection reason" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_TECHNOLOGY_PROVIDER_DOMAIN` :   Breaks down reporting data by the domain of the ad technology provider (ATP) associated with the bid. Corresponds to "Ad technology provider domain" in the Ad Manager UI. Compatible with the "Historical" report type. `PROGRAMMATIC_DEAL_ID` :   Breaks down reporting data by programmatic deal ID. Corresponds to "Deal ID" in the Ad Manager UI. Compatible with the "Historical" report type. `PROGRAMMATIC_DEAL_NAME` :   Breaks down reporting data by programmatic deal name. Corresponds to "Deal name" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_TECHNOLOGY_PROVIDER_ID` :   Breaks down reporting data by the ID of the ad technology provider (ATP) associated with the bid. Corresponds to "Ad technology provider ID" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_TECHNOLOGY_PROVIDER_NAME` :   Breaks down reporting data by the ad technology provider (ATP) associated with the bid. Corresponds to "Ad technology provider" in the Ad Manager UI. Compatible with the "Historical" report type. `TCF_VENDOR_ID` :   Breaks down reporting data by the ID of the ad technology provider as it appears on the Global Vendor List (GVL). Corresponds to "TCF vendor ID" in the Ad Manager UI. Compatible with the "Historical" report type. `TCF_VENDOR_NAME` :   Breaks down reporting data by the name of the ad technology provider as it appears on the Global Vendor List (GVL). Corresponds to "TCF vendor" in the Ad Manager UI. Compatible with the "Historical" report type. `SITE_NAME` :   Breaks down reporting data by site. Corresponds to "Site" in the Ad Manager UI. Compatible with the "Historical" report type. `CHANNEL_NAME` :   Breaks down reporting data by channels. Corresponds to "Channel" in the Ad Manager UI. Compatible with the "Historical" report type. `URL_ID` :   Breaks down reporting data by URL ID. Compatible with the "Historical" report type. `URL_NAME` :   Breaks down reporting data by URL name. Corresponds to "URL" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_AD_DURATION` :   Breaks down reporting data by video ad duration. Corresponds to "Video ad duration" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_AD_TYPE_ID` :   Breaks down reporting data by video ad type Id. Compatible with the "Historical" report type. `VIDEO_AD_TYPE_NAME` :   Breaks down reporting data by video ad type. Corresponds to "Video ad type" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_PRODUCT_CODE` :   Breaks down reporting data by Ad Exchange product code. Compatible with the "Historical" report type. `AD_EXCHANGE_PRODUCT_NAME` :   Breaks down reporting data by Ad Exchange product. Corresponds to "Ad Exchange product" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_ID` :   Breaks down reporting data by Dynamic allocation ID. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_NAME` :   Breaks down reporting data by Dynamic allocation. Corresponds to "Dynamic allocation" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_TYPE_ID` :   Breaks down reporting data by Ad type ID. Compatible with the "Historical" report type. `AD_TYPE_NAME` :   Breaks down reporting data by Ad type. Corresponds to "Ad type" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_LOCATION_ID` :   Breaks down reporting data by Ad location ID. Compatible with the "Historical" report type. `AD_LOCATION_NAME` :   Breaks down reporting data by Ad location. Corresponds to "Ad location" in the Ad Manager UI. Compatible with the "Historical" report type. `TARGETING_TYPE_CODE` :   Breaks down reporting data by Targeting type code. Compatible with the "Historical" report type. `TARGETING_TYPE_NAME` :   Breaks down reporting data by Targeting type. Corresponds to "Targeting type" in the Ad Manager UI. Compatible with the "Historical" report type. `BRANDING_TYPE_CODE` :   Breaks down reporting data by Branding type code. Compatible with the "Historical" report type. `BRANDING_TYPE_NAME` :   Breaks down reporting data by Branding type. Corresponds to "Branding type" in the Ad Manager UI. Compatible with the "Historical" report type. `BANDWIDTH_ID` :   Breaks down reporting data by Bandwidth Id. Compatible with the "Historical" report type. `BANDWIDTH_NAME` :   Breaks down reporting data by Bandwidth name. Corresponds to "Bandwidth" in the Ad Manager UI. Compatible with the "Historical" report type. `CARRIER_ID` :   Breaks down reporting data by Carrier Id. Compatible with the "Historical" report type. `CARRIER_NAME` :   Breaks down reporting data by Carrier name. Corresponds to "Carrier" in the Ad Manager UI. Compatible with the "Historical" report type. <br /> |
| ### `adUnitView` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery.AdUnitView ` The ad unit view for the report. Defaults to [AdUnitView.TOP_LEVEL](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery.AdUnitView#TOP_LEVEL). *** ** * ** *** **Enumerations** `TOP_LEVEL` :   Only the top level ad units. Metrics include events for their descendants that are not filtered out. `FLAT` :   All the ad units. Metrics do not include events for the descendants. `HIERARCHICAL` : Use the ad unit hierarchy. There will be as many ad unit columns as levels of ad units in the generated report: - The column [Dimension.AD_UNIT_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#AD_UNIT_NAME) is replaced with columns "Ad unit 1", "Ad unit 2", ... "Ad unit n". If level is not applicable to a row, "N/A" is returned as the value. - The column [Dimension.AD_UNIT_ID](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#AD_UNIT_ID) is replaced with columns "Ad unit ID 1", "Ad unit ID 2", ... "Ad unit ID n". If level is not applicable to a row, "N/A" is returned as the value. Metrics do not include events for the descendants. <br /> |
| ### `columns` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column[]` The list of trafficking statistics and revenue information being requested in the report. The generated report will contain the columns in the same order as requested. This field is required. *** ** * ** *** **Enumerations** `AD_SERVER_IMPRESSIONS` :   The number of impressions delivered by the ad server. Corresponds to "Ad server impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_BEGIN_TO_RENDER_IMPRESSIONS` :   The number of begin-to-render impressions delivered by the ad server. Corresponds to "Ad server begin to render impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_TARGETED_IMPRESSIONS` :   The number of impressions delivered by the ad server by explicit custom criteria targeting. Corresponds to "Ad server targeted impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_CLICKS` :   The number of clicks delivered by the ad server. Corresponds to "Ad server clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_TARGETED_CLICKS` :   The number of clicks delivered by the ad server by explicit custom criteria targeting. Corresponds to "Ad server targeted clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_CTR` :   The CTR for an ad delivered by the ad server. Corresponds to "Ad server CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_CPM_AND_CPC_REVENUE` :   The CPM and CPC revenue earned, calculated in publisher currency, for the ads delivered by the ad server. Corresponds to "Ad server CPM and CPC revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_CPM_AND_CPC_REVENUE_GROSS` :   The CPM and CPC revenue earned, calculated in publisher currency, for the ads delivered by the ad server. This includes pre-rev-share revenue for Programmatic traffic. This is a temporary metric to help with the transition from gross to net revenue reporting. Corresponds to "Ad server CPM and CPC revenue (gross)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_CPD_REVENUE` :   The CPD revenue earned, calculated in publisher currency, for the ads delivered by the ad server. Corresponds to "Ad server CPD revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ALL_REVENUE` :   All revenue earned, calculated in publisher currency, for the ads delivered by the ad server. Corresponds to "Ad server total revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ALL_REVENUE_GROSS` :   All gross revenue earned, calculated in publisher currency, for the ads delivered by the ad server. This includes pre-rev-share revenue for Programmatic traffic. This is a temporary metric to help with the transition from gross to net revenue reporting. Corresponds to "Ad server total revenue (gross)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_WITHOUT_CPD_AVERAGE_ECPM` :   The average estimated cost-per-thousand-impressions earned from the CPM and CPC ads delivered by the ad server. Corresponds to "Ad server average eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_WITH_CPD_AVERAGE_ECPM` :   The average estimated cost-per-thousand-impressions earned from all ads delivered by the ad server. `AD_SERVER_LINE_ITEM_LEVEL_PERCENT_IMPRESSIONS` :   The ratio of the number of impressions delivered to the total impressions delivered by the ad server for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad server impressions (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_LINE_ITEM_LEVEL_PERCENT_CLICKS` :   The ratio of the number of clicks delivered to the total clicks delivered by the ad server for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad server clicks (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_REVENUE` :   The ratio of revenue generated by ad server to the total CPM and CPC revenue earned by the ads delivered for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad server revenue (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE` :   The ratio of revenue generated by ad server to the total CPM, CPC and CPD revenue earned by the ads delivered for line item-level dynamic allocation. Represented as a percentage. `AD_SERVER_UNFILTERED_IMPRESSIONS` :   The number of downloaded impressions delivered by the ad server including impressions recognized as spam. Corresponds to "Ad server unfiltered downloaded impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_UNFILTERED_BEGIN_TO_RENDER_IMPRESSIONS` :   The number of begin to render impressions delivered by the ad server including impressions recognized as spam. Corresponds to "Ad server unfiltered begin to render impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_UNFILTERED_CLICKS` :   The number of clicks delivered by the ad server including clicks recognized as spam. Corresponds to "Ad server unfiltered clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_IMPRESSIONS` :   The number of impressions an AdSense ad delivered for line item-level dynamic allocation. Corresponds to "AdSense impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS` :   The number of impressions an AdSense ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. This metric is deprecated. Corresponds to "AdSense targeted impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_CLICKS` :   The number of clicks an AdSense ad delivered for line item-level dynamic allocation. Corresponds to "AdSense clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_TARGETED_CLICKS` :   The number of clicks an AdSense ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. This metric is deprecated. Corresponds to "AdSense targeted clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_CTR` :   The ratio of clicks an AdSense reservation ad delivered to the number of impressions it delivered, including line item-level dynamic allocation. Corresponds to "AdSense CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_REVENUE` :   Revenue generated from AdSense ads delivered for line item-level dynamic allocation. Corresponds to "AdSense revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_AVERAGE_ECPM` :   The average estimated cost-per-thousand-impressions earned from the ads delivered by AdSense for line item-level dynamic allocation. Corresponds to "AdSense average eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_PERCENT_IMPRESSIONS` :   The ratio of the number of impressions delivered by AdSense reservation ads to the total impressions delivered for line item-level dynamic allocation. Represented as a percentage. Corresponds to "AdSense impressions (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_PERCENT_CLICKS` :   The ratio of the number of clicks delivered by AdSense reservation ads to the total clicks delivered for line item-level dynamic allocation. Represented as a percentage. Corresponds to "AdSense clicks (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_REVENUE` :   The ratio of revenue to the total revenue earned from the CPM and CPC ads delivered by AdSense for line item-level dynamic allocation. Represented as a percentage. Corresponds to "AdSense revenue (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE` :   The ratio of revenue to the total revenue earned from all ads delivered by AdSense for line item-level dynamic allocation. Represented as a percentage. `AD_EXCHANGE_LINE_ITEM_LEVEL_IMPRESSIONS` :   The number of impressions an Ad Exchange ad delivered for line item-level dynamic allocation. Corresponds to "Ad Exchange impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `BID_COUNT` :   The number of bids associated with the selected dimensions. Corresponds to "Bids" in the Ad Manager UI. Compatible with the "Historical" report type. `BID_AVERAGE_CPM` :   The average CPM associated with these bids. Corresponds to "Average bid CPM" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_CALLOUTS` :   Number of times a yield partner is asked to return bid to fill a yield group request. Only applies to Open Bidding; not Mediation. This data is available for 45 days after the event. Corresponds to "Yield group callouts" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_SUCCESSFUL_RESPONSES` :   Number of times a yield group buyer successfully returned a bid in response to a yield group callout, even if that response is "no bids." Only applies to Open Bidding; not Mediation. This data is available for 45 days after the event. Corresponds to "Yield group successful responses" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_BIDS` :   Number of bids received from Open Bidding buyers, regardless of whether the returned bid competes in an auction. This number might be greater than Yield group callouts because a buyer can return multiple bids. Only applies to Open Bidding; not Mediation. This data is available for 45 days after the event. Corresponds to "Yield group bids" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_BIDS_IN_AUCTION` :   Number of bids received from Open Bidding buyers that competed in the auction. Some bids may be filtered out before the auction runs if the bidder's response omits required fields or contains a creative that violates Google's policies. Learn more about policies and enforcement. Only applies to Open Bidding; not Mediation. This data is available for 45 days after the event. Corresponds to "Yield group bids in auction" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_AUCTIONS_WON` :   Number of winning bids received from Open Bidding buyers, even when the winning bid is placed at the end of a mediation for mobile apps chain. Only applies to Open Bidding; not Mediation. This data is available for 45 days after the event. Corresponds to "Yield group auctions won" in the Ad Manager UI. Compatible with the "Historical" report type. `DEALS_BID_REQUESTS` :   Number of bid requests sent for each deal. Must be broken down by `PROGRAMMATIC_DEAL_ID` or `PROGRAMMATIC_DEAL_NAME`. Not tracked for Programmatic Guaranteed deals (will show zero on those rows). Corresponds to "Deals bid requests" in the Ad Manager UI. Compatible with the "Historical" report type. `DEALS_BIDS` :   Number of bids placed on each deal. Not tracked for Programmatic Guaranteed deals (will show zero on those rows). Corresponds to "Deals bids" in the Ad Manager UI. Compatible with the "Historical" report type. `DEALS_BID_RATE` :   Bid rate for each deal. Must be broken down by `PROGRAMMATIC_DEAL_ID` or `PROGRAMMATIC_DEAL_NAME`. Not tracked for Programmatic Guaranteed deals (will show N/A on those rows). Corresponds to "Deals bid rate" in the Ad Manager UI. Compatible with the "Historical" report type. `DEALS_WINNING_BIDS` :   Number of winning bids for each deal. Not tracked for Programmatic Guaranteed deals (will show zero on those rows). Corresponds to "Deals winning bids" in the Ad Manager UI. Compatible with the "Historical" report type. `DEALS_WIN_RATE` :   Win rate for each deal. Not tracked for Programmatic Guaranteed deals (will show N/A on those rows). Corresponds to "Deals win rate" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_IMPRESSIONS` :   Number of matched yield group requests where a yield partner delivered their ad to publisher inventory. Corresponds to "Yield group impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_ESTIMATED_REVENUE` :   Total net revenue earned by a yield group, based upon the yield group estimated CPM and yield group impressions recorded. This revenue already excludes Google revenue share. Corresponds to "Yield group estimated revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_ESTIMATED_CPM` :   The estimated net rate for yield groups or individual yield group partners. Corresponds to "Yield group estimated CPM" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_MEDIATION_FILL_RATE` :   Yield group Mediation fill rate indicating how often a network fills an ad request. Corresponds to "Mediation fill rate" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_MEDIATION_PASSBACKS` :   Passbacks are counted when an ad network is given a chance to serve but does not deliver an impression, and Ad Manager Mediation moves on to the next ad network in the mediation chain. Passbacks are not currently counted for the "Ad server" demand channel. Corresponds to "Mediation passbacks" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_MEDIATION_THIRD_PARTY_ECPM` :   Revenue per thousand impressions based on data collected by Ad Manager from third-party ad network reports. Displays zero if data collection is not enabled. Corresponds to "Mediation third-party eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `YIELD_GROUP_MEDIATION_CHAINS_SERVED` :   Total requests where a Mediation chain was served, even if none of the ad networks delivered an impression. Corresponds to "Mediation chains served" in the Ad Manager UI. Compatible with the "Historical" report type. `MEDIATION_THIRD_PARTY_ECPM` :   Mediation third-party average cost-per-thousand-impressions. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS` :   The number of impressions an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. This metric is deprecated. Corresponds to "Ad Exchange targeted impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_CLICKS` :   The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation. Corresponds to "Ad Exchange clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_TARGETED_CLICKS` :   The number of clicks an Ad Exchange ad delivered for line item-level dynamic allocation by explicit custom criteria targeting. This metric is deprecated. Corresponds to "Ad Exchange targeted clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_CTR` :   The ratio of clicks an Ad Exchange ad delivered to the number of impressions it delivered for line item-level dynamic allocation. Corresponds to "Ad Exchange CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_PERCENT_IMPRESSIONS` :   The ratio of the number of impressions delivered to the total impressions delivered by Ad Exchange for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad Exchange impressions (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_PERCENT_CLICKS` :   The ratio of the number of clicks delivered to the total clicks delivered by Ad Exchange for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad Exchange clicks (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_REVENUE` :   Revenue generated from Ad Exchange ads delivered for line item-level dynamic allocation. Represented in publisher currency and time zone. Corresponds to "Ad Exchange revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_WITHOUT_CPD_PERCENT_REVENUE` :   The ratio of revenue generated by Ad Exchange to the total revenue earned by CPM and CPC ads delivered for line item-level dynamic allocation. Represented as a percentage. Corresponds to "Ad Exchange revenue (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LINE_ITEM_LEVEL_WITH_CPD_PERCENT_REVENUE` :   The ratio of revenue generated by Ad Exchange to the total revenue earned by CPM, CPC and CPD ads delivered for line item-level dynamic allocation. Represented as a percentage. `AD_EXCHANGE_LINE_ITEM_LEVEL_AVERAGE_ECPM` :   The average estimated cost-per-thousand-impressions earned from the delivery of Ad Exchange ads for line item-level dynamic allocation. Corresponds to "Ad Exchange average eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS` :   The total number of impressions delivered including line item-level dynamic allocation. Corresponds to "Total impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_TARGETED_IMPRESSIONS` :   The total number of impressions delivered including line item-level dynamic allocation by explicit custom criteria targeting. Corresponds to "Total targeted impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_CLICKS` :   The total number of clicks delivered including line item-level dynamic allocation. Corresponds to "Total clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_TARGETED_CLICKS` :   The total number of clicks delivered including line item-level dynamic allocation by explicit custom criteria targeting Corresponds to "Total targeted clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_CTR` :   The ratio of total clicks on ads delivered by the ad servers to the total number of impressions delivered for an ad including line item-level dynamic allocation. Corresponds to "Total CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE` :   The total CPM and CPC revenue generated by the ad servers including line item-level dynamic allocation. Corresponds to "Total CPM and CPC revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE` :   The total CPM, CPC and CPD revenue generated by the ad servers including line item-level dynamic allocation. Corresponds to "Total revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_WITHOUT_CPD_AVERAGE_ECPM` :   Estimated cost-per-thousand-impressions (eCPM) of CPM and CPC ads delivered by the ad servers including line item-level dynamic allocation. Corresponds to "Total average eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_LINE_ITEM_LEVEL_WITH_CPD_AVERAGE_ECPM` :   Estimated cost-per-thousand-impressions (eCPM) of CPM, CPC and CPD ads delivered by the ad servers including line item-level dynamic allocation. `TOTAL_CODE_SERVED_COUNT` :   The total number of times that the code for an ad is served by the ad server including inventory-level dynamic allocation. Corresponds to "Total code served count" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_AD_REQUESTS` :   The total number of times that an ad request is sent to the ad server including dynamic allocation. Corresponds to "Total ad requests" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_RESPONSES_SERVED` :   The total number of times that an ad is served by the ad server including dynamic allocation. Corresponds to "Total responses served" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_UNMATCHED_AD_REQUESTS` :   The total number of times that an ad is not returned by the ad server. Corresponds to "Total unmatched ad requests" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_FILL_RATE` :   The fill rate indicating how often an ad request is filled by the ad server including dynamic allocation. Corresponds to "Total fill rate" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_RESPONSES_SERVED` :   The total number of times that an ad is served by the ad server. Corresponds to "Ad server responses served" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_RESPONSES_SERVED` :   The total number of times that an AdSense ad is delivered. Corresponds to "AdSense responses served" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_RESPONSES_SERVED` :   The total number of times that an Ad Exchange ad is delivered. Corresponds to "Ad Exchange responses served" in the Ad Manager UI. Compatible with the "Historical" report type. `PROGRAMMATIC_RESPONSES_SERVED` :   Total number of ad responses served from programmatic demand sources. Includes Ad Exchange, Open Bidding, and Preferred Deals. Differs from Ad Exchange responses served, which doesn't include Open Bidding matched ad requests. Corresponds to "Programmatic responses served" in the Ad Manager UI. Compatible with the "Historical" report type. `PROGRAMMATIC_MATCH_RATE` :   The number of programmatic responses served divided by the number of requests eligible for programmatic. Includes Ad Exchange, Open Bidding, and Preferred Deals. Corresponds to "Programmatic match rate" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_PROGRAMMATIC_ELIGIBLE_AD_REQUESTS` :   The total number of ad requests eligible for programmatic inventory, including Programmatic Guaranteed, Preferred Deals, backfill, and open auction. For optimized pods, this metric will count a single opportunity when the pod doesn't fill with programmatic demand. When it does fill, it will count each matched query. Corresponds to "Programmatic eligible ad requests" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_OPPORTUNITIES` :   The total number of video opportunities. Corresponds to "True opportunities" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_CAPPED_OPPORTUNITIES` :   The total number of video capped opportunities. Corresponds to "Capped opportunities" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_MATCHED_OPPORTUNITIES` :   The total number of video matched opportunities. Corresponds to "Matched opportunities" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_MATCHED_DURATION` :   The total filled duration in ad breaks. Corresponds to "Matched duration (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_DURATION` :   The total duration in ad breaks. Corresponds to "Total duration (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_BREAK_START` :   The total number of break starts. Corresponds to "Break start" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_VIDEO_BREAK_END` :   The total number of break ends. Corresponds to "Break end" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_INVENTORY_LEVEL_UNFILLED_IMPRESSIONS` :   The total number of missed impressions due to the ad servers' inability to find ads to serve, including inventory-level dynamic allocation. Corresponds to "Unfilled impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `UNIQUE_REACH_FREQUENCY` :   Corresponds to "Average impressions/unique visitor" in the Ad Manager UI. Compatible with the "Reach" report type. `UNIQUE_REACH_IMPRESSIONS` :   Corresponds to "Total reach impressions" in the Ad Manager UI. Compatible with the "Reach" report type. `UNIQUE_REACH` :   Corresponds to "Total unique visitors" in the Ad Manager UI. Compatible with the "Reach" report type. `SDK_MEDIATION_CREATIVE_IMPRESSIONS` :   The number of impressions for a particular SDK mediation creative. Corresponds to "SDK mediation creative impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `SDK_MEDIATION_CREATIVE_CLICKS` :   The number of clicks for a particular SDK mediation creative. Corresponds to "SDK mediation creative clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `SELL_THROUGH_FORECASTED_IMPRESSIONS` :   The number of forecasted impressions for future sell-through reports. This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down. Corresponds to "Forecasted impressions" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `PARTNER_SALES_PARTNER_IMPRESSIONS` :   The number of partner-sold impressions served to the YouTube partner ad inventory. Corresponds to "Partner-sold impressions" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_PARTNER_CODE_SERVED` :   The number of times the ad server responded to a request for the YouTube partner ad inventory. Corresponds to "Partner-sold code served count" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_GOOGLE_IMPRESSIONS` :   The number of Google-sold impressions served to the YouTube partner ad inventory. Corresponds to "Google-sold impressions" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_GOOGLE_RESERVATION_IMPRESSIONS` :   The number of Google-sold reservation impressions served to the YouTube partner ad inventory. Corresponds to "Google-sold reservation impressions" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_GOOGLE_AUCTION_IMPRESSIONS` :   The number of Google-sold auction impressions served to the YouTube partner ad inventory. Corresponds to "Google-sold auction impressions" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_QUERIES` :   The total number of ad requests that were eligible to serve to the YouTube partner ad inventory. Corresponds to "Total ad requests" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_FILLED_QUERIES` :   The number of ad requests for the YouTube partner ad inventory that were filled with at least 1 ad. This includes both partner-sold and Google-sold requests. Google-sold can fill at most 2 ads, while partner-sold can fill at most 1 ad. Corresponds to "Filled ad requests" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `PARTNER_SALES_SELL_THROUGH_RATE` :   The fill rate percentage of filled requests to total ad requests. Corresponds to "Fill rate" in the Ad Manager UI. Compatible with the "YouTube consolidated" report type. `SELL_THROUGH_AVAILABLE_IMPRESSIONS` :   The number of available impressions for future sell-through reports. This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down. Corresponds to "Available impressions" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `SELL_THROUGH_RESERVED_IMPRESSIONS` :   The number of reserved impressions for future sell-through reports. This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down. Corresponds to "Reserved impressions" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `SELL_THROUGH_SELL_THROUGH_RATE` :   The sell-through rate for impressions for future sell-through reports. This metric is available for the next 90 days with a daily break down and for the next 12 months with a monthly break down. Corresponds to "Sell-through rate" in the Ad Manager UI. Compatible with the "Future sell-through" report type. `RICH_MEDIA_BACKUP_IMAGES` :   The total number of times a backup image is served in place of a rich media ad. Corresponds to "Backup image impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_DISPLAY_TIME` :   The amount of time(seconds) that each rich media ad is displayed to users. Corresponds to "Total display time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_AVERAGE_DISPLAY_TIME` :   The average amount of time(seconds) that each rich media ad is displayed to users. Corresponds to "Average display time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_EXPANSIONS` :   The number of times an expanding ad was expanded. Corresponds to "Total expansions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_EXPANDING_TIME` :   The average amount of time(seconds) that an expanding ad is viewed in an expanded state. Corresponds to "Average expanding time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_INTERACTION_TIME` :   The average amount of time(seconds) that a user interacts with a rich media ad. Corresponds to "Interaction time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_INTERACTION_COUNT` :   The number of times that a user interacts with a rich media ad. Corresponds to "Total interactions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_INTERACTION_RATE` :   The ratio of rich media ad interactions to the number of times the ad was displayed. Represented as a percentage. Corresponds to "Interaction rate" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_AVERAGE_INTERACTION_TIME` :   The average amount of time(seconds) that a user interacts with a rich media ad. Corresponds to "Average interaction time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_INTERACTION_IMPRESSIONS` :   The number of impressions where a user interacted with a rich media ad. Corresponds to "Interactive impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_MANUAL_CLOSES` :   The number of times that a user manually closes a floating, expanding, in-page with overlay, or in-page with floating ad. Corresponds to "Manual closes" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_FULL_SCREEN_IMPRESSIONS` :   A metric that measures an impression only once when a user opens an ad in full screen mode. Corresponds to "Full-screen impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_INTERACTIONS` :   The number of times a user clicked on the graphical controls of a video player. Corresponds to "Total video interactions" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_INTERACTION_RATE` :   The ratio of video interactions to video plays. Represented as a percentage. Corresponds to "Video interaction rate" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_MUTES` :   The number of times a rich media video was muted. Corresponds to "Mute" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_PAUSES` :   The number of times a rich media video was paused. Corresponds to "Pause" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_PLAYES` :   The number of times a rich media video was played. Corresponds to "Plays" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_MIDPOINTS` :   The number of times a rich media video was played up to midpoint. Corresponds to "Midpoint" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_COMPLETES` :   The number of times a rich media video was fully played. Corresponds to "Complete" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_REPLAYS` :   The number of times a rich media video was restarted. Corresponds to "Replays" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_STOPS` :   The number of times a rich media video was stopped. Corresponds to "Stops" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_UNMUTES` :   The number of times a rich media video was unmuted. Corresponds to "Unmute" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_VIEW_TIME` :   The average amount of time(seconds) that a rich media video was viewed per view. Corresponds to "Average view time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_VIDEO_VIEW_RATE` :   The percentage of a video watched by a user. Corresponds to "View rate" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_CUSTOM_EVENT_TIME` :   The amount of time (seconds) that a user interacts with a rich media ad. Corresponds to "Custom event - time" in the Ad Manager UI. Compatible with the "Historical" report type. `RICH_MEDIA_CUSTOM_EVENT_COUNT` :   The number of times a user views and interacts with a specified part of a rich media ad. Corresponds to "Custom event - count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_START` :   The number of impressions where the video was played. Corresponds to "Start" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_FIRST_QUARTILE` :   The number of times the video played to 25% of its length. Corresponds to "First quartile" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_MIDPOINT` :   The number of times the video reached its midpoint during play. Corresponds to "Midpoint" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_THIRD_QUARTILE` :   The number of times the video played to 75% of its length. Corresponds to "Third quartile" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_COMPLETE` :   The number of times the video played to completion. Corresponds to "Complete" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_AVERAGE_VIEW_RATE` :   Average percentage of the video watched by users. Corresponds to "Average view rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_AVERAGE_VIEW_TIME` :   Average time(seconds) users watched the video. Corresponds to "Average view time" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_COMPLETION_RATE` :   Percentage of times the video played to the end. Corresponds to "Completion rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_TOTAL_ERROR_COUNT` :   The number of times an error occurred, such as a VAST redirect error, a video playback error, or an invalid response error. Corresponds to "Total error count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_VIDEO_LENGTH` :   Duration of the video creative. Corresponds to "Video length" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_SKIP_BUTTON_SHOWN` :   The number of times a skip button is shown in video. Corresponds to "Skip button shown" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_ENGAGED_VIEW` :   The number of engaged views i.e. ad is viewed to completion or for 30s, whichever comes first. Corresponds to "Engaged view" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_VIEW_THROUGH_RATE` :   View-through rate represented as a percentage. Corresponds to "View-through rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_AUTO_PLAYS` :   Number of times that the publisher specified a video ad played automatically. Corresponds to "Auto-plays" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_CLICK_TO_PLAYS` :   Number of times that the publisher specified a video ad was clicked to play. Corresponds to "Click-to-plays" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_VIEWERSHIP_TOTAL_ERROR_RATE` :   Error rate is the percentage of video error count from (error count + total impressions). Corresponds to "Total error rate" in the Ad Manager UI. Compatible with the "Historical" report type. `DROPOFF_RATE` :   The drop-off rate. Corresponds to "Drop-off rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_TRUEVIEW_VIEWS` :   Number of times a video ad has been viewed to completion or watched to 30 seconds, whichever happens first. Corresponds to "TrueView views" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_TRUEVIEW_SKIP_RATE` :   Percentage of times a user clicked Skip. Corresponds to "TrueView skip rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_TRUEVIEW_VTR` :   TrueView views divided by TrueView impressions. Corresponds to "TrueView VTR" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_100_COUNT` :   Number of VAST video errors of type 100. Corresponds to "VAST error 100 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_101_COUNT` :   Number of VAST video errors of type 101. Corresponds to "VAST error 101 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_102_COUNT` :   Number of VAST video errors of type 102. Corresponds to "VAST error 102 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_200_COUNT` :   Number of VAST video errors of type 200. Corresponds to "VAST error 200 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_201_COUNT` :   Number of VAST video errors of type 201. Corresponds to "VAST error 201 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_202_COUNT` :   Number of VAST video errors of type 202. Corresponds to "VAST error 202 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_203_COUNT` :   Number of VAST video errors of type 203. Corresponds to "VAST error 203 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_300_COUNT` :   Number of VAST video errors of type 300. Corresponds to "VAST error 300 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_301_COUNT` :   Number of VAST video errors of type 301. Corresponds to "VAST error 301 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_302_COUNT` :   Number of VAST video errors of type 302. Corresponds to "VAST error 302 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_303_COUNT` :   Number of VAST video errors of type 303. Corresponds to "VAST error 303 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_400_COUNT` :   Number of VAST video errors of type 400. Corresponds to "VAST error 400 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_401_COUNT` :   Number of VAST video errors of type 401. Corresponds to "VAST error 401 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_402_COUNT` :   Number of VAST video errors of type 402. Corresponds to "VAST error 402 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_403_COUNT` :   Number of VAST video errors of type 403. Corresponds to "VAST error 403 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_405_COUNT` :   Number of VAST video errors of type 405. Corresponds to "VAST error 405 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_500_COUNT` :   Number of VAST video errors of type 500. Corresponds to "VAST error 500 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_501_COUNT` :   Number of VAST video errors of type 501. Corresponds to "VAST error 501 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_502_COUNT` :   Number of VAST video errors of type 502. Corresponds to "VAST error 502 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_503_COUNT` :   Number of VAST video errors of type 503. Corresponds to "VAST error 503 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_600_COUNT` :   Number of VAST video errors of type 600. Corresponds to "VAST error 600 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_601_COUNT` :   Number of VAST video errors of type 601. Corresponds to "VAST error 601 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_602_COUNT` :   Number of VAST video errors of type 602. Corresponds to "VAST error 602 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_603_COUNT` :   Number of VAST video errors of type 603. Corresponds to "VAST error 603 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_604_COUNT` :   Number of VAST video errors of type 604. Corresponds to "VAST error 604 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_900_COUNT` :   Number of VAST video errors of type 900. Corresponds to "VAST error 900 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_ERRORS_VAST_ERROR_901_COUNT` :   Number of VAST video errors of type 901. Corresponds to "VAST error 901 count" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_PAUSE` :   Video interaction event: The number of times user paused ad clip. Corresponds to "Pause" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_RESUME` :   Video interaction event: The number of times the user unpaused the video. Corresponds to "Resume" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_REWIND` :   Video interaction event: The number of times a user rewinds the video. Corresponds to "Rewind" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_MUTE` :   Video interaction event: The number of times video player was in mute state during play of ad clip. Corresponds to "Mute" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_UNMUTE` :   Video interaction event: The number of times a user unmutes the video. Corresponds to "Unmute" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_COLLAPSE` :   Video interaction event: The number of times a user collapses a video, either to its original size or to a different size. Corresponds to "Collapse" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_EXPAND` :   Video interaction event: The number of times a user expands a video. Corresponds to "Expand" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_FULL_SCREEN` :   Video interaction event: The number of times ad clip played in full screen mode. Corresponds to "Full screen" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_AVERAGE_INTERACTION_RATE` :   Video interaction event: The number of user interactions with a video, on average, such as pause, full screen, mute, etc. Corresponds to "Average interaction rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_INTERACTION_VIDEO_SKIPS` :   Video interaction event: The number of times a skippable video is skipped. Corresponds to "Video skipped" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_STARTS` :   The number of control starts. Corresponds to "Control starts" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_STARTS` :   The number of optimized starts. Corresponds to "Optimized starts" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_COMPLETES` :   The number of control completes. Corresponds to "Control completes" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETES` :   The number of optimized completes. Corresponds to "Optimized completes" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_COMPLETION_RATE` :   The rate of control completions. Corresponds to "Control completion rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETION_RATE` :   The rate of optimized completions. Corresponds to "Optimized completion rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_COMPLETION_RATE_LIFT` :   The percentage by which optimized completion rate is greater than the unoptimized completion rate. This is calculated as (( [Column.VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETION_RATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#VIDEO_OPTIMIZATION_OPTIMIZED_COMPLETION_RATE)/ [Column.VIDEO_OPTIMIZATION_CONTROL_COMPLETION_RATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#VIDEO_OPTIMIZATION_CONTROL_COMPLETION_RATE)) - 1) \* 100 for an ad for which the optimization feature has been enabled. Corresponds to "Completion rate lift" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_SKIP_BUTTON_SHOWN` :   The number of control skip buttons shown. Corresponds to "Control skip button shown" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_SKIP_BUTTON_SHOWN` :   The number of optimized skip buttons shown. Corresponds to "Optimized skip button shown" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_ENGAGED_VIEW` :   The number of control engaged views. Corresponds to "Control engaged view" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_ENGAGED_VIEW` :   The number of optimized engaged views. Corresponds to "Optimized engaged view" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_CONTROL_VIEW_THROUGH_RATE` :   The control view-through rate. Corresponds to "Control view-through rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_OPTIMIZED_VIEW_THROUGH_RATE` :   The optimized view-through rate. Corresponds to "Optimized view-through rate" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_OPTIMIZATION_VIEW_THROUGH_RATE_LIFT` :   The percentage by which optimized view-through rate is greater than the unoptimized view-through rate. This is calculated as (( [Column.VIDEO_OPTIMIZATION_OPTIMIZED_VIEW_THROUGH_RATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#VIDEO_OPTIMIZATION_OPTIMIZED_VIEW_THROUGH_RATE)/ [Column.VIDEO_OPTIMIZATION_CONTROL_VIEW_THROUGH_RATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#VIDEO_OPTIMIZATION_CONTROL_VIEW_THROUGH_RATE)) - 1) \* 100 for an ad for which the optimization feature has been enabled. Corresponds to "View-through rate lift" in the Ad Manager UI. Compatible with the "Historical" report type. `VIDEO_IMPRESSIONS_REAL_TIME` :   Total impressions from the Google Ad Manager server, AdSense, Ad Exchange, and yield group partners. Corresponds to "Total impressions" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_MATCHED_QUERIES_REAL_TIME` :   Total number of matched queries. Corresponds to "Total responses served" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_UNMATCHED_QUERIES_REAL_TIME` :   Total number of unmatched queries. Corresponds to "Total unmatched ad requests" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_TOTAL_QUERIES_REAL_TIME` :   Total number of ad requests. Corresponds to "Total ad requests" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_CREATIVE_SERVE_REAL_TIME` :   Total number of creatives served. Corresponds to "Total creative serves" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_100_COUNT_REAL_TIME` :   Number of VAST video errors of type 100. Corresponds to "VAST error 100 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_101_COUNT_REAL_TIME` :   Number of VAST video errors of type 101. Corresponds to "VAST error 101 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_102_COUNT_REAL_TIME` :   Number of VAST video errors of type 102. Corresponds to "VAST error 102 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_200_COUNT_REAL_TIME` :   Number of VAST video errors of type 200. Corresponds to "VAST error 200 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_201_COUNT_REAL_TIME` :   Number of VAST video errors of type 201. Corresponds to "VAST error 201 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_202_COUNT_REAL_TIME` :   Number of VAST video errors of type 202. Corresponds to "VAST error 202 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_203_COUNT_REAL_TIME` :   Number of VAST video errors of type 203. Corresponds to "VAST error 203 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_300_COUNT_REAL_TIME` :   Number of VAST video errors of type 300. Corresponds to "VAST error 300 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_301_COUNT_REAL_TIME` :   Number of VAST video errors of type 301. Corresponds to "VAST error 301 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_302_COUNT_REAL_TIME` :   Number of VAST video errors of type 302. Corresponds to "VAST error 302 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_303_COUNT_REAL_TIME` :   Number of VAST video errors of type 303. Corresponds to "VAST error 303 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_400_COUNT_REAL_TIME` :   Number of VAST video errors of type 400. Corresponds to "VAST error 400 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_401_COUNT_REAL_TIME` :   Number of VAST video errors of type 401. Corresponds to "VAST error 401 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_402_COUNT_REAL_TIME` :   Number of VAST video errors of type 402. Corresponds to "VAST error 402 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_403_COUNT_REAL_TIME` :   Number of VAST video errors of type 403. Corresponds to "VAST error 403 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_405_COUNT_REAL_TIME` :   Number of VAST video errors of type 405. Corresponds to "VAST error 405 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_500_COUNT_REAL_TIME` :   Number of VAST video errors of type 500. Corresponds to "VAST error 500 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_501_COUNT_REAL_TIME` :   Number of VAST video errors of type 501. Corresponds to "VAST error 501 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_502_COUNT_REAL_TIME` :   Number of VAST video errors of type 502. Corresponds to "VAST error 502 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_503_COUNT_REAL_TIME` :   Number of VAST video errors of type 503. Corresponds to "VAST error 503 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_600_COUNT_REAL_TIME` :   Number of VAST video errors of type 600. Corresponds to "VAST error 600 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_601_COUNT_REAL_TIME` :   Number of VAST video errors of type 601. Corresponds to "VAST error 601 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_602_COUNT_REAL_TIME` :   Number of VAST video errors of type 602. Corresponds to "VAST error 602 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_603_COUNT_REAL_TIME` :   Number of VAST video errors of type 603. Corresponds to "VAST error 603 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_604_COUNT_REAL_TIME` :   Number of VAST video errors of type 604. Corresponds to "VAST error 604 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_900_COUNT_REAL_TIME` :   Number of VAST video errors of type 900. Corresponds to "VAST error 900 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST3_ERROR_901_COUNT_REAL_TIME` :   Number of VAST video errors of type 901. Corresponds to "VAST error 901 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST4_ERROR_406_COUNT_REAL_TIME` :   Number of VAST video errors of type 406. Corresponds to "VAST error 406 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST4_ERROR_407_COUNT_REAL_TIME` :   Number of VAST video errors of type 407. Corresponds to "VAST error 407 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST4_ERROR_408_COUNT_REAL_TIME` :   Number of VAST video errors of type 408. Corresponds to "VAST error 408 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST4_ERROR_409_COUNT_REAL_TIME` :   Number of VAST video errors of type 409. Corresponds to "VAST error 409 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST4_ERROR_410_COUNT_REAL_TIME` :   Number of VAST video errors of type 410. Corresponds to "VAST error 410 count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `VIDEO_VAST_TOTAL_ERROR_COUNT_REAL_TIME` :   Number of total VAST video errors. Corresponds to "Total error count" in the Ad Manager UI. Compatible with the "Real-time video" report type. `TOTAL_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS` :   The total number of impressions viewed on the user's screen. Corresponds to "Total Active View viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS` :   The total number of impressions that were sampled and measured by active view. Corresponds to "Total Active View measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE` :   The percentage of total impressions viewed on the user's screen (out of the total impressions measurable by active view). `TOTAL_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS` :   Total number of impressions that were eligible to measure viewability. Corresponds to "Total Active View eligible impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE` :   The percentage of total impressions that were measurable by active view (out of all the total impressions sampled for active view). Corresponds to "Total Active View % measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME` :   Active View total average time in seconds that specific impressions are reported as being viewable. Corresponds to "Total Active View average viewable time (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `ACTIVE_VIEW_PERCENT_AUDIBLE_START_IMPRESSIONS` :   The percentage of total impressions from video creatives with audible playback at start, from all total measurable impressions for Active View. Corresponds to "Active View % audible at start" in the Ad Manager UI. Compatible with the "Historical" report type. `ACTIVE_VIEW_PERCENT_EVER_AUDIBLE_IMPRESSIONS` :   The percentage of total impressions from video creatives where volume \> 0 at any point, from all total impressions measurable for Active View. Corresponds to "Active View % ever audible" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS` :   The number of impressions delivered by the ad server viewed on the user's screen. Corresponds to "Ad server Active View viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS` :   The number of impressions delivered by the ad server that were sampled, and measurable by active view. Corresponds to "Ad server Active View measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by the ad server viewed on the user's screen (out of the ad server impressions measurable by active view). Corresponds to "Ad server Active View % viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS` :   Total number of impressions delivered by the ad server that were eligible to measure viewability. Corresponds to "Ad server Active View eligible impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by the ad server that were measurable by active view ( out of all the ad server impressions sampled for active view). Corresponds to "Ad server Active View % measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_REVENUE` :   Active View ad server revenue. Corresponds to "Ad server Active View revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_SERVER_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME` :   Active View ad server average time in seconds that specific impressions are reported as being viewable. Corresponds to "Ad server Active View average viewable time (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS` :   The number of impressions delivered by AdSense viewed on the user's screen, Corresponds to "AdSense Active View viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS` :   The number of impressions delivered by AdSense that were sampled, and measurable by active view. Corresponds to "AdSense Active View measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by AdSense viewed on the user's screen (out of AdSense impressions measurable by active view). Corresponds to "AdSense Active View % viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS` :   Total number of impressions delivered by AdSense that were eligible to measure viewability. Corresponds to "AdSense Active View eligible impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by AdSense that were measurable by active view ( out of all AdSense impressions sampled for active view). Corresponds to "AdSense Active View % measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `ADSENSE_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME` :   Active View AdSense average time in seconds that specific impressions are reported as being viewable. Corresponds to "AdSense Active View average viewable time (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS` :   The number of impressions delivered by Ad Exchange viewed on the user's screen, Corresponds to "Ad Exchange Active View viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS` :   The number of impressions delivered by Ad Exchange that were sampled, and measurable by active view. Corresponds to "Ad Exchange Active View measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by Ad Exchange viewed on the user's screen (out of Ad Exchange impressions measurable by active view). Corresponds to "Ad Exchange Active View % viewable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS` :   Total number of impressions delivered by Ad Exchange that were eligible to measure viewability. Corresponds to "Ad Exchange Active View eligible impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered by Ad Exchange that were measurable by active view ( out of all Ad Exchange impressions sampled for active view). Corresponds to "Ad Exchange Active View % measurable impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME` :   Active View AdExchange average time in seconds that specific impressions are reported as being viewable. Corresponds to "Ad Exchange Active View average viewable time (seconds)" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_TOTAL_REQUESTS` :   The total number of queries sent to Ad Exchange. Corresponds to "Ad Exchange ad requests" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_MATCH_RATE` :   The fraction of Ad Exchange queries that result in a matched query. Also known as "Coverage". Corresponds to "Ad Exchange match rate" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_COST_PER_CLICK` :   The amount earned per click on Ad Exchange. Corresponds to "Ad Exchange CPC" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_TOTAL_REQUEST_CTR` :   The fraction of Ad Exchange requests that result in a click. Corresponds to "Ad Exchange ad request CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_MATCHED_REQUEST_CTR` :   The fraction of Ad Exchange matched requests that result in a click. Corresponds to "Ad Exchange matched request CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_TOTAL_REQUEST_ECPM` :   The amount earned per thousand Ad Exchange requests. Corresponds to "Ad Exchange ad request eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_MATCHED_REQUEST_ECPM` :   The amount earned per thousand Ad Exchange matched requests. Corresponds to "Ad Exchange matched request eCPM" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_EXCHANGE_LIFT_EARNINGS` :   The increase in Ad Exchange revenue gained for won impressions over the applicable minimum CPM or the best price specified during dynamic allocation. Corresponds to "Ad Exchange lift" in the Ad Manager UI. Compatible with the "Historical" report type. `TOTAL_ACTIVE_VIEW_REVENUE` :   Active View total revenue. Corresponds to "Total Active View revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_COMPETING_TOTAL` :   The number of impressions sent to Ad Exchange / AdSense, regardless of whether they won or lost (total number of dynamic allocation impressions). Corresponds to "Impressions competing" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_OPPORTUNITY_UNFILLED_IMPRESSIONS_COMPETING` :   The number of unfilled queries that attempted dynamic allocation by Ad Exchange / AdSense. Corresponds to "Unfilled competing impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_OPPORTUNITY_ELIGIBLE_IMPRESSIONS_TOTAL` :   The number of Ad Exchange / AdSense and Ad Manager impressions. Corresponds to "Eligible impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_NOT_COMPETING_TOTAL` :   The difference between eligible impressions and competing impressions in dynamic allocation. `DYNAMIC_ALLOCATION_OPPORTUNITY_IMPRESSIONS_NOT_COMPETING_PERCENT_TOTAL` :   The percentage of eligible impressions that are not competing in dynamic allocation. Corresponds to "Impressions not competing (%)" in the Ad Manager UI. Compatible with the "Historical" report type. `DYNAMIC_ALLOCATION_OPPORTUNITY_SATURATION_RATE_TOTAL` :   The percent of eligible impressions participating in dynamic allocation. `DYNAMIC_ALLOCATION_OPPORTUNITY_MATCH_RATE_TOTAL` :   The percent of total dynamic allocation queries that won. Corresponds to "Dynamic allocation match rate" in the Ad Manager UI. Compatible with the "Historical" report type. `INVOICED_IMPRESSIONS` :   The number of invoiced impressions. Corresponds to "Invoiced impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `INVOICED_UNFILLED_IMPRESSIONS` :   The number of invoiced unfilled impressions. Corresponds to "Invoiced unfilled impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `NIELSEN_IMPRESSIONS` :   The total number of impressions tracked for Nielsen Digital Ad Ratings measurement. Corresponds to "Impressions" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_IMPRESSIONS` :   The total number of impressions for in-target demographic tracked for Nielsen Digital Ad Ratings measurement. Corresponds to "In-target impressions" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_POPULATION_BASE` :   The population in the demographic. Corresponds to "Population base" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_POPULATION_BASE` :   The total population for all in-target demographics. Compatible with the "Reach" report type. `NIELSEN_UNIQUE_AUDIENCE` :   The total number of different people within the selected demographic who were reached. Corresponds to "Unique audience" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_UNIQUE_AUDIENCE` :   The total number of different people within all in-target demographics who were reached. Compatible with the "Reach" report type. `NIELSEN_PERCENT_AUDIENCE_REACH` :   The unique audience reached as a percentage of the population base. Corresponds to "% audience reach" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_PERCENT_AUDIENCE_REACH` :   The unique audience reached as a percentage of the population base for all in-target demographics. Compatible with the "Reach" report type. `NIELSEN_AVERAGE_FREQUENCY` :   The average number of times that a person within the target audience sees an advertisement. Corresponds to "Average frequency" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_AVERAGE_FREQUENCY` :   The average number of times that a person within the target audience sees an advertisement for all in-target demographics. Compatible with the "Reach" report type. `NIELSEN_GROSS_RATING_POINTS` :   The unit of audience volume, which is based on the percentage of the reached target audience population multiplied by the average frequency. Corresponds to "Gross rating points" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_GROSS_RATING_POINTS` :   The unit of audience volume, which is based on the percentage of the reached target audience population multiplied by the average frequency, for all in-target demographics. Compatible with the "Reach" report type. `NIELSEN_PERCENT_IMPRESSIONS_SHARE` :   The share of impressions that reached the target demographic. Corresponds to "% impression share" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_PERCENT_IMPRESSIONS_SHARE` :   The share of impressions that reached all in-target demographics. Corresponds to "In-target % impression share" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_PERCENT_POPULATION_SHARE` :   The share of the total population represented by the population base. Corresponds to "% population share" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_PERCENT_POPULATION_SHARE` :   The share of the total population for all in-target demographics represented by the population base. Compatible with the "Reach" report type. `NIELSEN_PERCENT_AUDIENCE_SHARE` :   The share of the unique audience in the demographic. Corresponds to "% audience share" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_PERCENT_AUDIENCE_SHARE` :   The share of the unique audience for all in-target demographics. Compatible with the "Reach" report type. `NIELSEN_AUDIENCE_INDEX` :   The relative unique audience in the demographic compared with its share of the overall population. Corresponds to "Audience index" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_AUDIENCE_INDEX` :   The relative unique audience for all in-target demographics compared with its share of the overall population. Compatible with the "Reach" report type. `NIELSEN_IMPRESSIONS_INDEX` :   The relative impressions per person in the demographic compared with the impressions per person for the overall population. Corresponds to "Impressions index" in the Ad Manager UI. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_IMPRESSIONS_INDEX` :   The relative impressions per person for all in-target demographics compared with the impressions per person for the overall population. Compatible with the "Reach" report type. `NIELSEN_IN_TARGET_RATIO` :   The adjusted in-target impression share used for pacing and billing, based on the GRP pacing preferences indicated in your line item settings. Corresponds to "Processed Nielsen in-target rate" in the Ad Manager UI. Compatible with the "Reach" report type. `DP_IMPRESSIONS` :   Number of impressions delivered. Corresponds to "Impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_CLICKS` :   Number of clicks delivered Corresponds to "Clicks" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_QUERIES` :   Number of requests. Corresponds to "Queries" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_MATCHED_QUERIES` :   Number of requests where a buyer was matched with the Ad request. Corresponds to "Matched queries" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_COST` :   The revenue earned, calculated in publisher currency, for the ads delivered. Corresponds to "Cost" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ECPM` :   The average estimated cost-per-thousand-impressions earned from ads delivered. Corresponds to "Total Average eCPM" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS` :   Total number of impressions delivered by the ad server that were eligible to measure viewability. Corresponds to "Total Active View eligible impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS` :   The number of impressions delivered that were sampled and measurable by active view. Corresponds to "Total Active View measurable impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS` :   The number of impressions delivered that were viewed on the user's screen. Corresponds to "Total Active View viewable impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered that were measurable by active view (out of all the impressions sampled for active view). Corresponds to "Total Active View % measurable impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `DP_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS_RATE` :   The percentage of impressions delivered thar were viewed on the user's screen (out of the impressions measurable by active view). Corresponds to "Total Active View % viewable impressions" in the Ad Manager UI. Compatible with the "Ad Connector" report type. `PARTNER_MANAGEMENT_HOST_IMPRESSIONS` :   The host impressions in the partner management. Corresponds to "Partner management host impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_HOST_CLICKS` :   The host clicks in the partner management. Corresponds to "Partner management host clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_HOST_CTR` :   The host CTR in the partner management. Corresponds to "Partner management host CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_UNFILLED_IMPRESSIONS` :   The unfilled impressions in the partner management. Corresponds to "Partner management unfilled impressions" in the Ad Manager UI. Compatible with any of the following report types: Historical, Partner finance. `PARTNER_MANAGEMENT_PARTNER_IMPRESSIONS` :   The partner impressions in the partner management. Corresponds to "Partner management partner impressions" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_PARTNER_CLICKS` :   The partner clicks in the partner management. Corresponds to "Partner management partner clicks" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_PARTNER_CTR` :   The partner CTR in the partner management. Corresponds to "Partner management partner CTR" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_MANAGEMENT_GROSS_REVENUE` :   The gross revenue in the partner management. Corresponds to "Partner management gross revenue" in the Ad Manager UI. Compatible with the "Historical" report type. `PARTNER_FINANCE_HOST_IMPRESSIONS` :   Monthly host impressions for partner finance reports. Corresponds to "Host impressions" in the Ad Manager UI. Compatible with the "Partner finance" report type. `PARTNER_FINANCE_HOST_REVENUE` :   Monthly host revenue for partner finance reports. Corresponds to "Host revenue" in the Ad Manager UI. Compatible with the "Partner finance" report type. `PARTNER_FINANCE_HOST_ECPM` :   Monthly host eCPM for partner finance reports. Corresponds to "Host eCPM" in the Ad Manager UI. Compatible with the "Partner finance" report type. `PARTNER_FINANCE_PARTNER_REVENUE` :   Monthly partner revenue for partner finance reports. Corresponds to "Partner revenue" in the Ad Manager UI. Compatible with the "Partner finance" report type. `PARTNER_FINANCE_PARTNER_ECPM` :   Monthly partner eCPM for partner finance reports. Corresponds to "Partner eCPM" in the Ad Manager UI. Compatible with the "Partner finance" report type. `PARTNER_FINANCE_GROSS_REVENUE` :   Monthly gross revenue for partner finance reports. Corresponds to "Gross revenue" in the Ad Manager UI. Compatible with the "Partner finance" report type. `CREATIVE_LOAD_TIME_0_500_MS_PERCENT` :   The ratio of the number of impressions for which the creative load time is between 0 and 500 ms to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time 0 - 500ms (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `CREATIVE_LOAD_TIME_500_1000_MS_PERCENT` :   The ratio of the number of impressions for which the creative load time is between 500 milliseconds and 1 second to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time 500ms - 1s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `CREATIVE_LOAD_TIME_1_2_S_PERCENT` :   The ratio of the number of impressions for which the creative load time is between 1 second and 2 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time 1s - 2s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `CREATIVE_LOAD_TIME_2_4_S_PERCENT` :   The ratio of the number of impressions for which the creative load time is between 2 seconds and 4 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time 2s - 4s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `CREATIVE_LOAD_TIME_4_8_S_PERCENT` :   The ratio of the number of impressions for which the creative load time is between 4 seconds and 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time 4s - 8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `CREATIVE_LOAD_TIME_GREATER_THAN_8_S_PERCENT` :   The ratio of the number of impressions for which the creative load time is greater than 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Creative load time \>8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `UNVIEWED_REASON_SLOT_NEVER_ENTERED_VIEWPORT_PERCENT` :   The ratio of the number of impressions which are unviewed because the ad slot never entered the viewport to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Slot never entered viewport (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `UNVIEWED_REASON_USER_SCROLLED_BEFORE_AD_FILLED_PERCENT` :   The ratio of the number of impressions which are unviewed because the user scrolled before the ad filled to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "User scrolled before ad filled (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `UNVIEWED_REASON_USER_SCROLLED_BEFORE_AD_LOADED_PERCENT` :   The ratio of the number of impressions which are unviewed because the user scrolled or navigated before the ad loaded to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "User scrolled/navigated before ad loaded (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `UNVIEWED_REASON_USER_SCROLLED_BEFORE_1_S_PERCENT` :   The ratio of the number of impressions which are unviewed because the user scrolled or navigated before one second to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "User scrolled/navigated before 1 second (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `UNVIEWED_REASON_OTHER_PERCENT` :   The ratio of the number of impressions which are unviewed because the of another non-viewable-impression reason to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Other non-viewable impression reasons (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_0_500_MS_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is between 0 and 500 milliseconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time 0 - 500ms (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_500_1000_MS_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is between 500 milliseconds and 1 second to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time 500ms - 1s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_1_2_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is between 1 second and 2 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time 1s - 2s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_2_4_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is between 2 seconds and 4 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time 2s - 4s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_4_8_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is between 4 seconds and 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time 4s - 8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_TAG_LOADED_TIME_GREATER_THAN_8_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to tag log time is greater than 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to tag loaded time \>8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_0_500_MS_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is between 0 and 500 milliseconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time 0 - 500ms (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_500_1000_MS_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is between 500 milliseconds and 1 second to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time 500ms - 1s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_1_2_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is between 1 second and 2 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time 1s - 2s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_2_4_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is between 2 seconds and 4 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time 2s - 4s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_4_8_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is between 4 seconds and 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time 4s - 8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `PAGE_NAVIGATION_TO_FIRST_AD_REQUEST_TIME_GREATER_THAN_8_S_PERCENT` :   The ratio of the number of impressions for which the DOM load to first ad request time is greater than 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Page navigation to first ad request time \>8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_0_500_MS_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is between 0 and 500 milliseconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time 0 - 500ms (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_500_1000_MS_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is between 500 milliseconds and 1 second to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time 500ms - 1s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_1_2_S_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is between 1 second and 2 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time 1s - 2s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_2_4_S_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is between 2 seconds and 4 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time 2s - 4s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_4_8_S_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is between 4 seconds and 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time 4s - 8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. `TAG_LOAD_TO_FIRST_AD_REQUEST_TIME_GREATER_THAN_8_S_PERCENT` :   The ratio of the number of impressions for which the tag load to first ad request time is greater than 8 seconds to the total number of impressions that have ad latency data, represented as a percentage. Corresponds to "Tag loaded to first ad request time \>8s (%)" in the Ad Manager UI. Compatible with the "Ad speed" report type. <br /> |
| ### `dimensionAttributes` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DimensionAttribute[]` The list of break-down attributes being requested in this report. Some [DimensionAttribute](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DimensionAttribute) values can only be used with certain [Dimension](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension) values that must be included in the [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions) attribute. The generated report will contain the attributes in the same order as requested. *** ** * ** *** **Enumerations** `LINE_ITEM_LABELS` :   Represents [LineItem.effectiveAppliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#effectiveAppliedLabels) as a comma separated list of [Label.name](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#name) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Line item labels" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_LABEL_IDS` :   Represents [LineItem.effectiveAppliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#effectiveAppliedLabels) as a comma separated list of [Label.id](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#id) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_OPTIMIZABLE` :   Generated as `true` for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) which is eligible for optimization, `false` otherwise. Can be used for filtering. Corresponds to "Optimizable" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_DELIVERY_INDICATOR` :   Indicates the progress made for the delivery of the [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). | Progress | Definition | |---|---| | 100% | The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is on track to deliver in full as per [LineItem.unitsBought](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#unitsBought). | | \> 100% | The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is on track to overdeliver. | | \< 100% | The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) is on track to underdeliver. | | N/A | The [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) does not have any quantity goals, or there is insufficient information about the [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem). | Corresponds to "Delivery Indicator" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach, Real-time video. `LINE_ITEM_DELIVERY_PACING` :   Represents [LineItem.deliveryRateType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#deliveryRateType) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Delivery pacing" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_FREQUENCY_CAP` :   Represents [LineItem.frequencyCaps](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#frequencyCaps) as a comma separated list of "[FrequencyCap.maxImpressions](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.FrequencyCap#maxImpressions) impressions per/every [FrequencyCap.numTimeUnits](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.FrequencyCap#numTimeUnits) [FrequencyCap.timeUnit](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.FrequencyCap#timeUnit)" (e.g. "10 impressions every day,500 impressions per lifetime") for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Frequency cap" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_RECONCILIATION_STATUS` :   Represents the monthly reconciliation status of the line item for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) and [Dimension.MONTH_YEAR](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#MONTH_YEAR). Corresponds to "Line item reconciliation status" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach. `LINE_ITEM_LAST_RECONCILIATION_DATE_TIME` :   Represents the monthly last reconciliation date time of the line item for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) and [Dimension.MONTH_YEAR](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#MONTH_YEAR). Corresponds to "Line item last reconciliation time" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach. `ADVERTISER_EXTERNAL_ID` :   Represents [Company.externalId](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#externalId) for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Corresponds to "External advertiser ID" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ADVERTISER_TYPE` :   Represents [Company.type](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#type) for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Can be used for filtering. Corresponds to "Advertiser type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ADVERTISER_CREDIT_STATUS` :   Represents [Company.creditStatus](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#creditStatus) for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Can be used for filtering. Corresponds to "Advertiser credit status" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ADVERTISER_PRIMARY_CONTACT` :   Represents name and email address in the form of name(email) of primary contact for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Corresponds to "Advertiser primary contact" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_START_DATE_TIME` :   Represents the start date (in YYYY-MM-DD format) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Corresponds to "Order start date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_END_DATE_TIME` :   Represents the end date (in YYYY-MM-DD format) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Corresponds to "Order end date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_EXTERNAL_ID` :   Represents [Order.externalOrderId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#externalOrderId) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "External order ID" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_PO_NUMBER` :   Represents [Order.poNumber](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#poNumber) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Corresponds to "Order PO number" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_IS_PROGRAMMATIC` :   Represents [Order.orderIsProgrammatic](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#orderIsProgrammatic) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Corresponds to "Programmatic order" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_AGENCY` :   Represents the name of [Order.agencyId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#agencyId) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Agency" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_AGENCY_ID` :   Represents [Order.agencyId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#agencyId) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Corresponds to "Agency ID" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_LABELS` :   Represents [Order.effectiveAppliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#effectiveAppliedLabels) as a comma separated list of [Label.name](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#name) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Order labels" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_LABEL_IDS` :   Represents [Order.effectiveAppliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#effectiveAppliedLabels) as a comma separated list of [Label.id](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#id) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Compatible with any of the following report types: Historical, Reach. `ORDER_TRAFFICKER` :   The name and email address in the form of name(email) of the trafficker for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME) Corresponds to "Trafficker" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_TRAFFICKER_ID` :   Represents [Order.traffickerId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#traffickerId) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Can be used for filtering. Compatible with any of the following report types: Historical, Reach. `ORDER_SECONDARY_TRAFFICKERS` :   The names and email addresses as a comma separated list of name(email) of the [Order.secondaryTraffickerIds](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#secondaryTraffickerIds) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Secondary traffickers" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_SALESPERSON` :   The name and email address in the form of name(email) of the [Order.salespersonId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#salespersonId) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Salesperson" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_SECONDARY_SALESPEOPLE` :   The names and email addresses as a comma separated list of name(email) of the [Order.secondarySalespersonIds](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#secondarySalespersonIds) for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Secondary salespeople" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_LIFETIME_IMPRESSIONS` :   The total number of impressions delivered over the lifetime of an [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Order lifetime impressions" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_LIFETIME_CLICKS` :   The total number of clicks delivered over the lifetime of an [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Order lifetime clicks" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed. `ORDER_BOOKED_CPM` :   The cost of booking all the CPM ads for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Booked CPM" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ORDER_BOOKED_CPC` :   The cost of booking all the CPC ads for [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME). Corresponds to "Booked CPC" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_START_DATE_TIME` :   Represents the start date (in YYYY-MM-DD format) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Can be used for filtering. Corresponds to "Line item start date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_END_DATE_TIME` :   Represents the end date (in YYYY-MM-DD format) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Can be used for filtering. Corresponds to "Line item end date" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_EXTERNAL_ID` :   Represents [LineItem.externalId](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#externalId) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Can be used for filtering. Corresponds to "External Line Item ID" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_COST_TYPE` :   Represents [LineItem.costType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costType) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Can be used for filtering. Corresponds to "Cost type" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_COST_PER_UNIT` :   Represents [LineItem.costPerUnit](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#costPerUnit) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Rate" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_CURRENCY_CODE` :   Represents the 3 letter currency code for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Currency code" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_GOAL_QUANTITY` :   The total number of impressions, clicks or days that is reserved for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Goal quantity" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_AVERAGE_NUMBER_OF_VIEWERS` :   Corresponds to "Nielsen Average Number Of Viewers" in the Ad Manager UI. Compatible with the "Reach" report type. `LINE_ITEM_SPONSORSHIP_GOAL_PERCENTAGE` :   The ratio between the goal quantity for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) of [LineItemType.SPONSORSHIP](https://developers.google.com/ad-manager/api/reference/v202602/AdRuleService.LineItemType#SPONSORSHIP) and the [LINE_ITEM_GOAL_QUANTITY](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#LINE_ITEM_GOAL_QUANTITY). Represented as a number between 0..100. Corresponds to "Sponsorship goal (%)" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_LIFETIME_IMPRESSIONS` :   The total number of impressions delivered over the lifetime of a [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Line item lifetime impressions" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_LIFETIME_CLICKS` :   The total number of clicks delivered over the lifetime of a [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Line item lifetime clicks" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_PRIORITY` :   Represents [LineItem.priority](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#priority) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) as a value between 1 and 16. Can be used for filtering. Corresponds to "Line item priority" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `LINE_ITEM_COMPUTED_STATUS` :   Describes the computed [LineItem](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem) status that is derived from the current state of the line item. Compatible with any of the following report types: Historical, Future sell-through, Reach, Ad speed, Real-time video. `CREATIVE_OR_CREATIVE_SET` :   Indicates if a creative is a regular creative or creative set. Values will be 'Creative' or 'Creative set' Compatible with the "Historical" report type. `MASTER_COMPANION_TYPE` :   The type of creative in a creative set - master or companion. Corresponds to "Master or Companion" in the Ad Manager UI. Compatible with the "Historical" report type. `LINE_ITEM_CONTRACTED_QUANTITY` :   Represents the [LineItem.contractedUnitsBought](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#contractedUnitsBought) quantity for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Contracted quantity" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_DISCOUNT` :   Represents the [LineItem.discount](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#discount) for [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). The number is either a percentage or an absolute value depending on [LineItem.discountType](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.LineItem#discountType). Corresponds to "Discount" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `LINE_ITEM_NON_CPD_BOOKED_REVENUE` :   The cost of booking for a non-CPD [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME). Corresponds to "Booked revenue (exclude CPD)" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ADVERTISER_LABELS` :   Represents [Company.appliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#appliedLabels) as a comma separated list of [Label.name](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#name) for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Corresponds to "Advertiser labels" in the Ad Manager UI. Compatible with any of the following report types: Historical, Reach. `ADVERTISER_LABEL_IDS` :   Represents [Company.appliedLabels](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company#appliedLabels) as a comma separated list of [Label.id](https://developers.google.com/ad-manager/api/reference/v202602/LabelService.Label#id) for [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME). Compatible with any of the following report types: Historical, Reach. `CREATIVE_CLICK_THROUGH_URL` :   Represents the click-through URL for [Dimension.CREATIVE_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CREATIVE_NAME). Corresponds to "Click-through URL" in the Ad Manager UI. Compatible with the "Historical" report type. `CREATIVE_SSL_SCAN_RESULT` :   Represents whether a creative is SSL-compliant. Corresponds to "Creative SSL scan result" in the Ad Manager UI. Compatible with the "Historical" report type. `CREATIVE_SSL_COMPLIANCE_OVERRIDE` :   Represents whether a creative's SSL status was overridden. Corresponds to "Creative SSL compliance override" in the Ad Manager UI. Compatible with the "Historical" report type. `LINE_ITEM_CREATIVE_START_DATE` :   Represents a [LineItemCreativeAssociation.startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/LineItemCreativeAssociationService.LineItemCreativeAssociation#startDateTime) for a [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) and a [Dimension.CREATIVE_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CREATIVE_NAME). Includes the date without the time. Corresponds to "Creative start date" in the Ad Manager UI. Compatible with the "Historical" report type. `LINE_ITEM_CREATIVE_END_DATE` :   Represents a [LineItemCreativeAssociation.endDateTime](https://developers.google.com/ad-manager/api/reference/v202602/LineItemCreativeAssociationService.LineItemCreativeAssociation#endDateTime) for a [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) and a [Dimension.CREATIVE_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CREATIVE_NAME). Includes the date without the time. Corresponds to "Creative end date" in the Ad Manager UI. Compatible with the "Historical" report type. `CONTENT_CMS_NAME` :   Represents the [CmsContent.displayName](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.CmsContent#displayName) within the first element of [Content.cmsContent](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#cmsContent) for [Dimension.CONTENT_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CONTENT_NAME). Corresponds to "Content source name" in the Ad Manager UI. Compatible with any of the following report types: Historical, YouTube consolidated. `CONTENT_CMS_VIDEO_ID` :   Represents the [CmsContent.cmsContentId](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.CmsContent#cmsContentId) within the first element of [Content.cmsContent](https://developers.google.com/ad-manager/api/reference/v202602/ContentService.Content#cmsContent) for [Dimension.CONTENT_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CONTENT_NAME). Corresponds to "ID of the video in the content source" in the Ad Manager UI. Compatible with any of the following report types: Historical, YouTube consolidated. `CHILD_PARTNER_NAME` : Breaks down reporting data by child partner name in MCM "Manage Inventory". By default, this attribute is ordered by [Dimension.CHILD_NETWORK_CODE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CHILD_NETWORK_CODE). **This dimension only works for MCM "Manage Inventory" parent publishers.** Corresponds to "Child partner name" in the Ad Manager UI. Compatible with the "Historical" report type. `AD_UNIT_CODE` :   Represents [AdUnit.adUnitCode](https://developers.google.com/ad-manager/api/reference/v202602/InventoryService.AdUnit#adUnitCode) for [Dimension.AD_UNIT_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#AD_UNIT_NAME). Corresponds to "Ad unit code" in the Ad Manager UI. Compatible with any of the following report types: Historical, Future sell-through, Ad speed, Real-time video. <br /> |
| ### `customFieldIds` | ` xsd:long[]` The list of [CustomField.id](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomField#id) being requested in this report. To add a [CustomField](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomField) to the report, you must include its corresponding [Dimension](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension), determined by the [CustomField.entityType](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomField#entityType), as a [dimension](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions). | [CustomFieldEntityType.entityType](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomFieldEntityType#entityType) || |---|---| | [CustomFieldEntityType.LINE_ITEM](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomFieldEntityType#LINE_ITEM) | [Dimension.LINE_ITEM_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#LINE_ITEM_NAME) | | [CustomFieldEntityType.ORDER](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomFieldEntityType#ORDER) | [Dimension.ORDER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ORDER_NAME) | | [CustomFieldEntityType.CREATIVE](https://developers.google.com/ad-manager/api/reference/v202602/CustomFieldService.CustomFieldEntityType#CREATIVE) | [Dimension.CREATIVE_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CREATIVE_NAME) | <br /> |
| ### `cmsMetadataKeyIds` | ` xsd:long[]` The list of content CMS metadata key [IDs](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataKey#id) being requested in this report. Each of these IDs must have been defined in the [CMS metadata key](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataKey). This will include dimensions in the form of `CMS_METADATA_KEY[id]_ID` and `CMS_METADATA_KEY[id]_VALUE` where where `ID` is the ID of the [CMS metadata value](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataValue#id) and `VALUE` is the [name](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataValue#valueName). To add [IDs](https://developers.google.com/ad-manager/api/reference/v202602/CmsMetadataService.CmsMetadataKey#id), you must include [Dimension.CMS_METADATA](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CMS_METADATA) in [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions), and specify a non-empty list of content CMS metadata key IDs. The order of content CMS metadata columns in the report correspond to the place of [Dimension.CMS_METADATA](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CMS_METADATA) in [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions). For example, if [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions) contains the following dimensions in the order: [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME), [Dimension.CMS_METADATA](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CMS_METADATA) and [Dimension.COUNTRY_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#COUNTRY_NAME), and [cmsMetadataKeyIds](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#cmsMetadataKeyIds) contains the following IDs in the order: 1001 and 1002. The order of dimensions in the report will be: Dimension.ADVERTISER_NAME, Dimension.CMS_METADATA_KEY\[1001\]_VALUE, Dimension.CMS_METADATA_KEY\[1002\]_VALUE, Dimension.COUNTRY_NAME, Dimension.ADVERTISER_ID, Dimension.CMS_METADATA_KEY\[1001\]_ID, Dimension.CMS_METADATA_KEY\[1002\]_ID, Dimension.COUNTRY_CRITERIA_ID <br /> |
| ### `customDimensionKeyIds` | ` xsd:long[]` The list of custom dimension custom targeting key [IDs](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingKey#id) being requested in this report. This will include dimensions in the form of `TOP_LEVEL_DIMENSION_KEY[id]_ID` and `TOP_LEVEL_DIMENSION_KEY[id]_VALUE` where `ID` is the ID of the [custom targeting value](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue#id) and `VALUE` is the [name](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingValue#name). To add [IDs](https://developers.google.com/ad-manager/api/reference/v202602/CustomTargetingService.CustomTargetingKey#id), you must include [Dimension.CUSTOM_DIMENSION](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CUSTOM_DIMENSION) in [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions), and specify a non-empty list of custom targeting key IDs. The order of cusotm dimension columns in the report correspond to the place of [Dimension.CUSTOM_DIMENSION](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CUSTOM_DIMENSION) in [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions). For example, if [dimensions](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dimensions) contains the following dimensions in the order: [Dimension.ADVERTISER_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#ADVERTISER_NAME), [Dimension.CUSTOM_DIMENSION](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#CUSTOM_DIMENSION) and [Dimension.COUNTRY_NAME](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension#COUNTRY_NAME), and [customCriteriaCustomTargetingKeyIds](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#customCriteriaCustomTargetingKeyIds) contains the following IDs in the order: 1001 and 1002. The order of dimensions in the report will be: Dimension.ADVERTISER_NAME, Dimension.TOP_LEVEL_DIMENSION_KEY\[1001\]_VALUE, Dimension.TOP_LEVEL_DIMENSION_KEY\[1002\]_VALUE, Dimension.COUNTRY_NAME, Dimension.ADVERTISER_ID, Dimension.TOP_LEVEL_DIMENSION_KEY\[1001\]_ID, Dimension.TOP_LEVEL_DIMENSION_KEY\[1002\]_ID, Dimension.COUNTRY_CRITERIA_ID. <br /> |
| ### `startDate` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Date ` The start date from which the reporting information is gathered. The `ReportQuery#dateRangeType` field must be set to [DateRangeType.CUSTOM_DATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DateRangeType#CUSTOM_DATE) in order to use this. |
| ### `endDate` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Date ` The end date up to which the reporting information is gathered. The `ReportQuery#dateRangeType` field must be set to [DateRangeType.CUSTOM_DATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DateRangeType#CUSTOM_DATE) in order to use this. |
| ### `dateRangeType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DateRangeType ` The period of time for which the reporting data is being generated. In order to define custom time periods, set this to [DateRangeType.CUSTOM_DATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DateRangeType#CUSTOM_DATE). If set to [DateRangeType.CUSTOM_DATE](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.DateRangeType#CUSTOM_DATE), then [ReportQuery.startDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#startDate) and [ReportQuery.endDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#endDate) will be used. *** ** * ** *** **Enumerations** `TODAY` :   The current day. `YESTERDAY` :   The previous day. `LAST_WEEK` :   The last week, from monday to sunday. `LAST_MONTH` :   The previous month. `LAST_3_MONTHS` :   The last 3 full months. For example, if today is May 5, 2017, then LAST_3_MONTHS would go from February 1 to April 30. `REACH_LIFETIME` :   This will report on the last 93 days for the following columns: [Column.UNIQUE_REACH_IMPRESSIONS](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#UNIQUE_REACH_IMPRESSIONS), [Column.UNIQUE_REACH_FREQUENCY](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#UNIQUE_REACH_FREQUENCY), and [Column.UNIQUE_REACH](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Column#UNIQUE_REACH). `CUSTOM_DATE` :   Specifying this value will enable the user to specify [ReportQuery.startDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#startDate) and [ReportQuery.endDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#endDate). `NEXT_DAY` :   The next day. `NEXT_90_DAYS` :   The next ninety days. `NEXT_WEEK` :   The next week, from monday to sunday. `NEXT_MONTH` :   The next month. `CURRENT_AND_NEXT_MONTH` :   Beginning of the next day until the end of the next month. `NEXT_QUARTER` :   The next quarter. `NEXT_3_MONTHS` :   The next three months. `NEXT_12_MONTHS` :   The next twelve months. <br /> |
| ### `statement` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Statement ` Specifies a filter to use for reporting on data. This filter will be used in conjunction (joined with an AND statement) with the date range selected through [dateRangeType](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#dateRangeType), [startDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#startDate), and [endDate](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.ReportQuery#endDate). The syntax currently allowed for [Statement.query](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Statement#query) is `[WHERE <condition> {AND <condition> ...}]` \<condition\> `:= <property> = <value>` `<condition>` `:= <property> = <bind variable>` `<condition> := <property> IN <list>` `<bind variable> := :<name>` where property is the enumeration name of a [Dimension](https://developers.google.com/ad-manager/api/reference/v202602/ReportService.Dimension) that can be filtered. For example, the statement "WHERE LINE_ITEM_ID IN (34344, 23235)" can be used to generate a report for a specific set of line items Filtering on IDs is highly recommended over filtering on names, especially for geographical entities. When filtering on names, matching is case sensitive. <br /> |
| ### `reportCurrency` | ` xsd:string` The currency for revenue metrics. Defaults to the network currency if left `null`. The supported currency codes can be found in [this Help Center article.](https://support.google.com/adxseller/answer/6019533) |
| ### `timeZoneType` | ` https://developers.google.com/ad-manager/api/reference/v202602/ReportService.TimeZoneType ` *** ** * ** *** **Enumerations** `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. `PUBLISHER` :   Use the publisher's time zone. For Ad Manager reports, this time zone is compatible with all metrics. For Ad Exchange reports, this time zone is not compatible with "Bids" and "Deals" metrics. **Note:** if your report includes "time unit" dimensions, only the Ad Manager "time unit" dimensions are compatible with this timezone, e.g.: - `DATE` - `WEEK` - `MONTH_AND_YEAR` `PACIFIC` :   Use the PT time zone. This time zone is only compatible with Ad Exchange metrics in Historical report type. **Note:** if your report includes "time unit" dimensions, only the PT "time unit" dimensions are compatible with this timezone, e.g.: - `DATE_PT` - `WEEK_PT` - `MONTH_YEAR_PT` - `DAY_PT` <br /> |