enum Dimension (v202508)

    Service
    ReportService
    Dependencies
    ReportQuery
    ▼
    Dimension

    Dimension provides the break-down and filterable types available for running a ReportJob . Aggregate and percentage columns will be calculated based on these groupings.

    Namespace
    https://www.google.com/apis/ads/publisher/v202508
    Enumeration
    Description
    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 . Can be used to filter by 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 and LineItem.id are automatically included as columns in the report. Can be used to filter by 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 . Can be used to filter by line item type using 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 . Can be used to filter by 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 and Order.id are automatically included as columns in the report. Can be used to filter by 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 . Can be used to filter by 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 and Company.id are automatically included as columns in the report. Can be used to filter by 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 .

    Compatible with the "Historical" report type.

    AD_NETWORK_NAME
    The name of the network defined in 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 . Can be used to filter by 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 and User.id of the salesperson are automatically included as columns in the report. Can be used to filter by 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 or creative set id (master's Creative.id ) if the creative is part of a creative set. Can be used to filter by 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 and Creative.id are automatically included as columns in the report. Can be used to filter by 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 . 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 . Can be used to filter by AdUnit.id . AD_UNIT_NAME , i.e. 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 and AdUnit.id are automatically included as columns in the report. Can be used to filter by 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 . 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 . 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 . Can be used to filter by 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 and Placement.id are automatically included as columns in the report. Can be used to filter by 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 by using 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 . Can be used to filter by CustomTargetingValue.id .

    Compatible with the "Historical" report type.

    CUSTOM_CRITERIA
    Breaks down reporting data by custom criteria. The CustomTargetingValue is displayed in the form: CUSTOM_TARGETING_VALUE_ID , i.e. CustomTargetingValue.id is automatically included as a column in the report. Cannot be used for filtering; use 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 . Can be used to filter by 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 and Content.id are automatically included as columns in the report. Can be used to filter by 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 . Can be used to filter by 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 and ContentBundle.id are automatically included as columns in the report. Can be used to filter by 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 .

    This dimension can be used as a filter in the Statement in PQL syntax: CMS_METADATA_KEY[keyId]_ID = CMS metadata value ID

    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 . Can be used to filter by AdSpot.id .

    Compatible with the "Historical" report type.

    CUSTOM_SPOT_NAME
    Breaks down reporting data by content. AdSpot.name and AdSpot.id are automatically included as columns in the report. Can be used to filter by 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 .

    Compatible with any of the following report types: Historical, Partner finance.

    PARTNER_MANAGEMENT_PARTNER_NAME
    Breaks down reporting data by partner Company.name and Company.id are automatically included as columns in the report.

    Corresponds to "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 .

    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 and 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 "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 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 - values , 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.

    Can correspond to any of the following in the Ad Manager UI: Mobile OS, Devices. 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 .

    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 . 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 .

    Compatible with any of the following report types: Historical, Reach.

    PROGRAMMATIC_BUYER_NAME
    Breaks down reporting data by programmatic buyer name.

    Corresponds to "Programmatic 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 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 .
    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 unified pricing rule id.

    Compatible with the "Historical" report type.

    UNIFIED_PRICING_RULE_NAME
    Breaks down reporting data by unified pricing rule name.

    Corresponds to "Unified 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 "Programmatic 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 "Programmatic 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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: