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 |