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
AD_CLIENT_ID The ID of an ad client.
AD_FORMAT_CODE - Deprecated The code of an ad format. Examples: text, image, or html.
AD_FORMAT_NAME - Deprecated The name of an ad format. Examples: Text, Image, or Rich Media. The latter value is for the html format.
AD_UNIT_CODE The code of an ad unit. This value is not necessarily unique across ad clients. Example: 837572. Available for publisher-side reports only.
AD_UNIT_ID The unique ID of an ad unit. Example: ca-pub-088712:837572. Available for publisher-side reports only.
AD_UNIT_NAME The name of an ad unit. Available for publisher-side reports only.
AD_UNIT_SIZE_CODE The size code of an ad unit. Examples: 720x42, mobile_single. Available for publisher-side reports only.
AD_UNIT_SIZE_NAME The size name of an ad unit. Examples: 720x42, Single (Mobile). Available for publisher-side reports only.
BID_TYPE_CODE The type of a bid. Examples: cpc, cpm
BID_TYPE_NAME A bid type name. Examples are: CPC bids, CPM bids
CUSTOM_CHANNEL_CODE The code of a custom channel. Available for publisher-side reports only.
CUSTOM_CHANNEL_ID The ID of a custom channel. Available for publisher-side reports only.
CUSTOM_CHANNEL_NAME The name of a custom channel. Available for publisher-side reports only.
DATE A date in YYYYMMDD format.
HOSTED_AD_CLIENT_ID The ID of the publisher's ad client.
MONTH A month in YYYYMM format.
PRODUCT_CODE The code of a product. Examples: AFC, AFS.
PRODUCT_NAME The name of a product. Examples: AdSense for Content, AdSense for Search
REQUESTED_AD_TYPE_CODE The code of the type of the requested ad. Examples: IMAGE, RADLINK, or OTHER.
REQUESTED_AD_TYPE_NAME The name of the type of the requested ad. Examples: Display, Link unit, or Other.
SERVED_AD_TYPE_CODE The code of the type of the served ad. Examples: IMAGE, RADLINK, or OTHER.
SERVED_AD_TYPE_NAME The name of the type of the served ad. Examples: Display, Link unit, or Other.
TARGETING_TYPE_CODE A targeting type code. Examples: Keyword, WebSite, Publisher.
TARGETING_TYPE_NAME A targeting type name. Examples: Contextual, Reservation, Publisher
URL_CHANNEL_ID The ID of a URL channel. Available for publisher-side reports only.
URL_CHANNEL_NAME The name of a URL channel. Available for publisher-side reports only.
WEEK The date of the first day of a week in YYYYMMDD format.

Metrics

Note: units are returned as strings.

Metric Description Units
AD_REQUESTS The 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 The ratio of requested ad units or queries to the number returned to the site. Decimal 0-1
AD_REQUESTS_CTR The ratio of ad requests that resulted in a click. Decimal 0-1
AD_REQUESTS_RPM The revenue per thousand ad requests. This is calculated by dividing estimated revenue by the number of ad requests multiplied by 1000. Decimal
CLICKS The number of times a user clicked on a standard content ad. Decimal
COST_PER_CLICK The amount you earn each time a user clicks on your ad. CPC is calculated by dividing the estimated revenue by the number of clicks received. Decimal. See headers in the response for the currency.
EARNINGS The 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.
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 The ratio of IMPRESSIONS that resulted in a click. Integer
IMPRESSIONS_RPM The revenue per thousand IMPRESSIONS. This is calculated by dividing your estimated revenue by the number of matched queries multiplied by 1000. Integer
INDIVIDUAL_AD_IMPRESSIONS The number of times an individual ad is displayed on your website. 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 The ratio of individual ad impressions that resulted in a click. Decimal 0-1
INDIVIDUAL_AD_IMPRESSIONS_RPM The revenue per thousand individual ad impressions. This is calculated by dividing estimated revenue by the number of individual ad impressions multiplied by 1000. Decimal
MATCHED_AD_REQUESTS Another name for IMPRESSIONS. Integer
MATCHED_AD_REQUESTS_CTR Another name for IMPRESSIONS_CTR. Decimal 0-1
MATCHED_AD_REQUESTS_RPM Another name for IMPRESSIONS_RPM. Decimal
PAGE_VIEWS The number of page views. Integer
PAGE_VIEWS_CTR The ratio of individual page views that resulted in a click. Decimal 0-1
PAGE_VIEWS_RPM The revenue per thousand page views. This is calculated by dividing your estimated revenue by the number of page views multiplied by 1000. Decimal
TOTAL_EARNINGS The estimated earnings made by both the publisher and the host. Decimal. See headers in the response for the currency.