Dimension

Reporting dimensions.

Any dimension described as "localized" will contain members translated according to the languageCode specified in a report generation request.

All localized dimensions pair with another "code" or "ID" dimension whose members are invariant with respect to the requested language.

Enums
DIMENSION_UNSPECIFIED Unspecified dimension.
DATE Date dimension in YYYY-MM-DD format (e.g. "2010-02-10").
WEEK

Week dimension in YYYY-MM-DD format, representing the first day of each week (e.g. "2010-02-08").

The first day of the week is determined by the languageCode specified in a report generation request (so e.g. this would be a Monday for "en-GB" or "es", but a Sunday for "en" or "fr-CA").

MONTH Month dimension in YYYY-MM format (e.g. "2010-02").
ACCOUNT_NAME

Account name.

The members of this dimension match the values from Account.display_name.

AD_CLIENT_ID

Unique ID of an ad client.

The members of this dimension match the values from AdClient.reporting_dimension_id.

HOSTED_AD_CLIENT_ID

Unique ID of a sub-account's ad client.

The members of this dimension match the values from AdClient.reporting_dimension_id (for the sub-account).

PRODUCT_NAME Localized product name (e.g. "AdSense for Content", "AdSense for Search").
PRODUCT_CODE

Product code (e.g. "AFC", "AFS").

The members of this dimension match the values from AdClient.product_code.

AD_UNIT_NAME

Ad unit name (within which an ad was served).

The members of this dimension match the values from AdUnit.display_name.

AD_UNIT_ID

Unique ID of an ad unit (within which an ad was served).

The members of this dimension match the values from AdUnit.reporting_dimension_id.

AD_UNIT_SIZE_NAME Localized size of an ad unit (e.g. "728x90", "Responsive").
AD_UNIT_SIZE_CODE The size code of an ad unit (e.g. "728x90", "responsive").
CUSTOM_CHANNEL_NAME

Custom channel name.

The members of this dimension match the values from CustomChannel.display_name.

CUSTOM_CHANNEL_ID

Unique ID of a custom channel.

The members of this dimension match the values from CustomChannel.reporting_dimension_id.

OWNED_SITE_DOMAIN_NAME

Domain name of a verified site (e.g. "example.com").

The members of this dimension match the values from Site.domain.

OWNED_SITE_ID

Unique ID of a verified site.

The members of this dimension match the values from Site.reporting_dimension_id.

PAGE_URL

URL of the page upon which the ad was served.

This is a complete URL including scheme and query parameters. Note that the URL that appears in this dimension may be a canonicalized version of the one that was used in the original request, and so may not exactly match the URL that a user might have seen.

Note that there are also some caveats to be aware of when using this dimension. For more information, see Page URL breakdown.

URL_CHANNEL_NAME

Name of a URL channel.

The members of this dimension match the values from UrlChannel.uri_pattern.

URL_CHANNEL_ID

Unique ID of a URL channel.

The members of this dimension match the values from UrlChannel.reporting_dimension_id.

BUYER_NETWORK_NAME Name of an ad network that returned the winning ads for an ad request (e.g. "Google AdWords"). Note that unlike other "NAME" dimensions, the members of this dimensions are not localized.
BUYER_NETWORK_ID Unique (opaque) ID of an ad network that returned the winning ads for an ad request.
BID_TYPE_NAME Localized bid type name (e.g. "CPC bids", "CPM bids") for a served ad.
BID_TYPE_CODE Type of a bid (e.g. "cpc", "cpm") for a served ad.
CREATIVE_SIZE_NAME Localized creative size name (e.g. "728x90", "Dynamic") of a served ad.
CREATIVE_SIZE_CODE Creative size code (e.g. "728x90", "dynamic") of a served ad.
DOMAIN_NAME Localized name of a host on which an ad was served, after IDNA decoding (e.g. "www.google.com", "Web caches and other", "bücher.example").
DOMAIN_CODE Name of a host on which an ad was served (e.g. "www.google.com", "webcaches", "xn--bcher-kva.example").
COUNTRY_NAME Localized region name of a user viewing an ad (e.g. "United States", "France").
COUNTRY_CODE CLDR region code of a user viewing an ad (e.g. "US", "FR").
PLATFORM_TYPE_NAME Localized platform type name (e.g. "High-end mobile devices", "Desktop").
PLATFORM_TYPE_CODE Platform type code (e.g. "HighEndMobile", "Desktop").
TARGETING_TYPE_NAME Localized targeting type name (e.g. "Contextual", "Personalized", "Run of Network").
TARGETING_TYPE_CODE Targeting type code (e.g. "Keyword", "UserInterest", "RunOfNetwork").
CONTENT_PLATFORM_NAME Localized content platform name an ad request was made from (e.g. "AMP", "Web").
CONTENT_PLATFORM_CODE Content platform code an ad request was made from (e.g. "AMP", "HTML").
AD_PLACEMENT_NAME Localized ad placement name (e.g. "Ad unit", "Global settings", "Manual").
AD_PLACEMENT_CODE Ad placement code (e.g. "AD_UNIT", "ca-pub-123456:78910", "OTHER").
REQUESTED_AD_TYPE_NAME Localized requested ad type name (e.g. "Display", "Link unit", "Other").
REQUESTED_AD_TYPE_CODE Requested ad type code (e.g. "IMAGE", "RADLINK", "OTHER").
SERVED_AD_TYPE_NAME Localized served ad type name (e.g. "Display", "Link unit", "Other").
SERVED_AD_TYPE_CODE Served ad type code (e.g. "IMAGE", "RADLINK", "OTHER").
AD_FORMAT_NAME Localized ad format name indicating the way an ad is shown to the users on your site (e.g. "In-page", "Anchor", "Vignette").
AD_FORMAT_CODE Ad format code indicating the way an ad is shown to the users on your site (e.g. "ON_PAGE", "ANCHOR", "INTERSTITIAL").
CUSTOM_SEARCH_STYLE_NAME Custom search style name.
CUSTOM_SEARCH_STYLE_ID Custom search style id.
DOMAIN_REGISTRANT Domain registrants.
WEBSEARCH_QUERY_STRING Query strings for web searches.