Metrics and Dimensions

This page provides tables that list and describe the available dimensions and metrics.

Dimensions

Note: CODE and ID are used programmatically while NAME is displayed to an end user and can be localised.

Dimension Description
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.
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).
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_PLACEMENT_CODE Ad placement code (e.g. AD_UNIT, ca-pub-123456:78910, OTHER).
AD_PLACEMENT_NAME Localized ad placement name (e.g. Ad unit, Global settings, Manual).
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_NAME Ad unit name (within which an ad was served). The members of this dimension match the values from AdUnit.display_name.
AD_UNIT_SIZE_CODE The size code of an ad unit (e.g. 728x90, responsive).
AD_UNIT_SIZE_NAME Localized size of an ad unit (e.g. 728x90, Responsive).
BID_TYPE_CODE Type of a bid (e.g. cpc, cpm) for a served ad.
BID_TYPE_NAME Localized bid type name (e.g. CPC bids, CPM bids) for a served ad.
BUYER_NETWORK_ID Unique (opaque) ID of an ad network that returned the winning ads for an ad request.
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.
CONTENT_PLATFORM_CODE Content platform code an ad request was made from (e.g. AMP, HTML).
CONTENT_PLATFORM_NAME Localized content platform name an ad request was made from (e.g. AMP, Web).
COUNTRY_CODE CLDR region code of a user viewing an ad (e.g. US, FR).
COUNTRY_NAME Localized region name of a user viewing an ad (e.g. United States, France).
CREATIVE_SIZE_CODE Creative size code (e.g. 728x90, dynamic) of a served ad.
CREATIVE_SIZE_NAME Localized creative size name (e.g. 728x90, Dynamic) of a served ad.
CUSTOM_CHANNEL_ID Unique ID of a custom channel. The members of this dimension match the values from CustomChannel.reporting_dimension_id.
CUSTOM_CHANNEL_NAME Custom channel name. The members of this dimension match the values from CustomChannel.display_name.
CUSTOM_SEARCH_STYLE_ID Custom search style id.
CUSTOM_SEARCH_STYLE_NAME Custom search style name.
DATE Date dimension in YYYY-MM-DD format (e.g. 2010-02-10).
DOMAIN_CODE Name of a host on which an ad was served (e.g. www.google.com, webcaches, xn--bcher-kva.example).
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_REGISTRANT Domain registrants.
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).
MONTH Month dimension in YYYY-MM format (e.g. 2010-02).
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.
PLATFORM_TYPE_CODE Platform type code (e.g. HighEndMobile, Desktop).
PLATFORM_TYPE_NAME Localized platform type name (e.g. High-end mobile devices, Desktop).
PRODUCT_CODE Product code (e.g. AFC, AFS). The members of this dimension match the values from AdClient.product_code.
PRODUCT_NAME Localized product name (e.g. AdSense for Content, AdSense for Search).
REQUESTED_AD_TYPE_CODE Requested ad type code (e.g. IMAGE, RADLINK, OTHER).
REQUESTED_AD_TYPE_NAME Localized requested ad type name (e.g. Display, Link unit, Other).
SERVED_AD_TYPE_CODE Served ad type code (e.g. IMAGE, RADLINK, OTHER).
SERVED_AD_TYPE_NAME Localized served ad type name (e.g. Display, Link unit, Other).
TARGETING_TYPE_CODE Targeting type code (e.g. Keyword, UserInterest, RunOfNetwork).
TARGETING_TYPE_NAME Localized targeting type name (e.g. Contextual, Personalized, Run of Network).
URL_CHANNEL_ID Unique ID of a URL channel. The members of this dimension match the values from UrlChannel.reporting_dimension_id.
URL_CHANNEL_NAME Name of a URL channel. The members of this dimension match the values from UrlChannel.uri_pattern.
WEBSEARCH_QUERY_STRING Query strings for web searches.
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 language_code 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).

Metrics

Note: units are returned as strings.

Metric Description Units
ACTIVE_VIEW_MEASURABILITY Ratio of requests that were measurable for viewability. Decimal 0-1
ACTIVE_VIEW_TIME Mean time an ad was displayed on screen. Decimal (as milliseconds)
ACTIVE_VIEW_VIEWABILITY Ratio of requests that were viewable. Decimal 0-1
ADS_PER_IMPRESSION Number of ad views per impression. Decimal
AD_REQUESTS Number of ad units that requested ads (for content ads) or search queries (for search ads). An ad request may result in zero, one, or multiple individual ad impressions depending on the size of the ad unit and whether any ads were available. Integer
AD_REQUESTS_COVERAGE Ratio of requested ad units or queries to the number returned to the site. Decimal 0-1
AD_REQUESTS_CTR Ratio of ad requests that resulted in a click. Decimal 0-1
AD_REQUESTS_RPM Revenue per thousand ad requests. This is calculated by dividing estimated revenue by the number of ad requests multiplied by 1000. Decimal. See headers in the response for the currency.
AD_REQUESTS_SPAM_RATIO Fraction of ad requests considered to be spam. Only available to premium accounts. Decimal 0-1
CLICKS Number of times a user clicked on a standard content ad. Integer
CLICKS_SPAM_RATIO Fraction of clicks considered to be spam. Only available to premium accounts. Decimal 0-1
COST_PER_CLICK Amount the publisher earns each time a user clicks on an ad. CPC is calculated by dividing the estimated revenue by the number of clicks received. Decimal. See headers in the response for the currency.
ESTIMATED_EARNINGS Estimated earnings of the publisher. Note that earnings up to yesterday are accurate, more recent earnings are estimated due to the possibility of spam, or exchange rate fluctuations. Decimal. See headers in the response for the currency.
FUNNEL_CLICKS Number of times a user clicked on a non-ad unit, triggering further ad requests. For more information, see Funnel clicks. Integer
FUNNEL_IMPRESSIONS Number of requests for non-ad units ads that returned content that was shown to the user. For more information, see Funnel impressions. Integer
FUNNEL_REQUESTS Number of requests for non-ad units (for example a related search unit). For more information, see Funnel requests. Integer
FUNNEL_RPM Revenue per thousand funnel impressions. This is calculated by dividing estimated revenue by the number of funnel impressions multiplied by 1000. For more information, see Funnel RPM. Decimal. See headers in the response for the currency.
IMPRESSIONS Impressions. An impression is counted for each ad request where at least one ad has been downloaded to the user’s device and has begun to load. It is the number of ad units (for content ads) or search queries (for search ads) that showed ads. Integer
IMPRESSIONS_CTR Ratio of IMPRESSIONS that resulted in a click. Decimal 0-1
IMPRESSIONS_RPM Revenue per thousand ad impressions. This is calculated by dividing estimated revenue by the number of ad impressions multiplied by 1000. Decimal. See headers in the response for the currency.
IMPRESSIONS_SPAM_RATIO Fraction of impressions considered to be spam. Only available to premium accounts. Decimal 0-1
INDIVIDUAL_AD_IMPRESSIONS Ads shown. Different ad formats will display varying numbers of ads. For example, a vertical banner may consist of 2 or more ads. Also, the number of ads in an ad unit may vary depending on whether the ad unit is displaying standard text ads, expanded text ads or image ads. Integer
INDIVIDUAL_AD_IMPRESSIONS_CTR Ratio of individual ad impressions that resulted in a click. Decimal 0-1
INDIVIDUAL_AD_IMPRESSIONS_RPM Revenue per thousand individual ad impressions. This is calculated by dividing estimated revenue by the number of individual ad impressions multiplied by 1000. Decimal. See headers in the response for the currency.
INDIVIDUAL_AD_IMPRESSIONS_SPAM_RATIO Fraction of ad impressions considered to be spam. Only available to premium accounts. Decimal 0-1
MATCHED_AD_REQUESTS Requests that returned at least one ad. Integer
MATCHED_AD_REQUESTS_CTR Ratio of clicks to matched requests. Decimal 0-1
MATCHED_AD_REQUESTS_RPM Revenue per thousand matched ad requests. This is calculated by dividing estimated revenue by the number of matched ad requests multiplied by 1000. Decimal. See headers in the response for the currency.
MATCHED_AD_REQUESTS_SPAM_RATIO Fraction of ad requests that returned ads considered to be spam. Only available to premium accounts. Decimal 0-1
PAGE_VIEWS Number of page views. Integer
PAGE_VIEWS_CTR Ratio of individual page views that resulted in a click. Decimal 0-1
PAGE_VIEWS_RPM Revenue per thousand page views. This is calculated by dividing the estimated revenue by the number of page views multiplied by 1000. Decimal. See headers in the response for the currency.
PAGE_VIEWS_SPAM_RATIO Fraction of page views considered to be spam. Only available to premium accounts. Decimal 0-1
TOTAL_EARNINGS Total earnings are the gross estimated earnings from revenue shared traffic before any parent and child account revenue share is applied. Decimal. See headers in the response for the currency.
TOTAL_IMPRESSIONS Impressions. An impression is counted for each ad request where at least one ad has been downloaded to the user’s device and has begun to load. It is the number of ad units (for content ads) or search queries (for search ads) that showed ads. Integer
WEBSEARCH_RESULT_PAGES Number of results pages. Integer