Use Historical report core dimensions & metrics
Core dimensions and metrics are dimensions and metrics that work together in Ad Manager Historical reports in most situations, making it easier to understand which are compatible with one another. When you use core dimensions and metrics together in your Ad Manager Historical report, you can assume that they'll usually follow these rules:
- All core dimensions will be compatible with all core metrics.
- All core dimensions will be compatible with all non-core metrics.
- All core dimensions plus any single non-core dimension will be compatible with all core metrics.
In this article:
Core dimensions
The following table contains a list of the core dimensions available for your Ad Manager Historical report.
| Name and description | Categories |
|---|---|
| Date
Daily breakdown of data. In Ad Manager, the data is shown in an extended format, such as Monday, January 18, 2016. The exported format is more compact, for example M/D/YY.
Note: The exported date format is based on the language and/or location associated with the Google account of the person creating the report. In reports created by other users, such as scheduled reports, the exported date format may differ from the format in reports created by you. |
Label Time unit |
| Week Weekly date range, formatted as "M/D/YY - M/D/YY". |
Label Time unit |
| Day of the week Calendar day of the week (for example, Monday, Tuesday). |
Label Time unit |
| Month and year The related month and year. Example: "October 2019." |
Label Time unit |
|
Ad unit (all levels)
The name of the ad unit. Select dimension attributes to display the ad unit code. |
Label Inventory |
|
Placement
Name of the placement that currently includes an ad unit associated with an impression, click, or other event. This is a flattened version of the Placement (all) dimension. Impressions, clicks, revenue, and other metrics can appear in multiple report rows. Learn more |
Label Inventory |
| Line item The name of the line item associated with the Creative that served to the ad slot request. |
Label Delivery |
| Line item type Type of line item associated to the Creative that served to the ad slot request. |
Label Delivery |
| Order The name of the Order associated to the line item linked to the Creative that served to the ad slot request. |
Label Delivery |
| Advertiser The name of the advertiser company assigned to an order. Select other dimensions to display labels, advertiser type, and more. |
Label Delivery |
| Country Country associated with IP address from ad slot request. |
Label Geography |
|
Demand channel
Displays the method buyers used to access your inventory. This dimension helps you report across your entire network. Values include:
|
Label Delivery |
| Device category Shows delivery by device category: Connected TV (CTV) device (Beta) , Desktop, Feature phone, Set-top box (STB), Smart display, Smartphone, Smart speaker, and Tablet. |
Label Platform |
| Programmatic channel Channel of transaction. Includes Preferred Deals, Programmatic Guaranteed, Private Auctions, and the Open Auction. Transactions via First Look are included in Open Auction transactions. |
Label Delivery |
|
Request type
Shows performance broken out by the technology used to request the ad. This allows for advanced troubleshooting, such as investigating discrepancies between served and downloaded impressions. Possible values are:
Note that the value "Google Ad Manager Tag" is no longer in use, but shows for compatibility reasons. |
Label Platform |
| Creative Creative that served to the ad slot request. Select dimension attributes to display click-through URL, SSL scan results, or custom fields. |
Label Delivery |
|
Creative size
Size of creative that served to the ad slot request. Creative size doesn't represent the actual size of a creative being served. This dimension represents the "Targeted Ad Unit Size" of the creative which is served. Since a Creative size can only be associated with filled impressions, this dimension is not compatible with the Unfilled impressions metric. When the Creative size dimension is included in a report, companion delivery that is otherwise rolled up under master delivery is surfaced, so you may see higher totals than expected. |
Label Delivery |
| Creative type Type of creative that served to the ad slot request. |
Label Delivery |
|
Inventory type (platform)
Shows performance by general groups of inventory. Possible values are:
|
Label Platform |
|
Rendered creative size (delivered)
The size of the ad slot where creatives are served from Ad Manager or Ad Exchange. This value may differ from the creative size reported in Ad Exchange. Possible values include:
Any other values show as "Unknown". Note: This dimension can't appear in the same report as the "Unfilled impressions" metric. They are incompatible. |
Label Delivery |
| Custom dimensions View dimensions created from key-values defined in your network. Learn more |
Label Inventory |
Core metrics
The following table contains a list of the core metrics available for your Ad Manager Historical report.
| Name and description | Categories |
|---|---|
|
Total impressions
Total impressions from the Google Ad Manager server, AdSense, Ad Exchange, and yield group partners. Learn more about how Ad Manager counts impressions. The "Total impressions" metric does not count impressions served by companion ads. To include the number of impressions served by companion in your report, add the "Master and Companion creative" dimension available in Historical report type. |
Label Total |
|
Ad server impressions
Impressions counted after the ad is downloaded in the user's device. This doesn't require that the ad content be fully loaded. This total excludes impressions from Ad Exchange and AdSense. It usually takes about 30 minutes for new impressions to be recorded and added to the total displayed here. |
Label Ad server |
| AdSense impressions Total impressions delivered by AdSense. |
Label AdSense |
| Ad Exchange impressions Total impressions delivered by the Ad Exchange. |
Label Ad Exchange |
| Ad server impressions % Ratio of impressions delivered by the Google Ad Manager server in relation to the total impressions delivered. |
Label Ad server |
| AdSense impressions % Ratio of impressions delivered by AdSense through line item dynamic allocation in relation to the total impressions delivered. |
Label AdSense |
| Ad Exchange impressions % Ratio of impressions delivered by Ad Exchange through line item dynamic allocation in relation to the total impressions delivered. |
Label Ad Exchange |
|
Total clicks
Total clicks served by the Google Ad Manager server, AdSense, and Ad Exchange. |
Label Total |
| Ad server clicks Total clicks served by the Google Ad Manager server. It usually takes about 30 minutes for new clicks to be recorded and added to the total displayed in reporting. |
Label Ad server |
| AdSense clicks Total clicks delivered by AdSense. |
Label AdSense |
| Ad Exchange clicks Total clicks delivered by the Ad Exchange. |
Label Ad Exchange |
| Ad server clicks % Ratio of clicks delivered by the Google Ad Manager server in relation to the total clicks delivered. |
Label Ad server |
| AdSense clicks % Ratio of clicks delivered by AdSense through line item dynamic allocation in relation to the total clicks delivered. |
Label AdSense |
| Ad Exchange clicks % Ratio of clicks delivered by Ad Exchange through line item dynamic allocation in relation to the total clicks delivered. |
Label Ad Exchange |
|
Total CPM and CPC revenue
Total amount of CPM and CPC revenue based on the number of units served by the Google Ad Manager server, AdSense, Ad Exchange, and third-party Mediation networks. |
Label Total |
|
Ad server CPM and CPC revenue |
Label Ad server |
| AdSense revenue Revenue generated from AdSense through line item dynamic allocation, calculated in your network's currency and time zone. |
Label AdSense |
| Ad Exchange revenue Revenue generated from the Ad Exchange through line item dynamic allocation, calculated in your network's currency and time zone. |
Label Ad Exchange |
|
Ad server revenue %
Ratio of revenue generated by the Google Ad Manager server in relation to the total revenue. |
Label Ad server |
| AdSense revenue % Ratio of revenue generated by AdSense through line item dynamic allocation in relation to the total revenue. |
Label AdSense |
| Ad Exchange revenue % Ratio of revenue generated by Ad Exchange through line item dynamic allocation in relation to the total revenue. |
Label Ad Exchange |
|
Total average eCPM
eCPM averaged across the Google Ad Manager server, AdSense, Ad Exchange, and third-party Mediation networks. |
Label Total |
|
Ad server average eCPM
Average effective cost-per-thousand-impressions earned from the ads delivered by the Google Ad Manager server. Formula:[(Ad server CPM + CPC + CPD + vCPM revenue)/Ad server impressions] x 1000 If the 'Ad server CPD revenue' metric is disabled under the "Ad server" metrics family, the CPD value is excluded from the average eCPM computation. For example, using the Key-values dimension makes the 'Ad server CPD revenue' unavailable, therefore eliminating the CPD value from your report.
|
Label Ad server |
|
AdSense average eCPM
The average effective cost-per-thousand-impressions earned from the ads delivered by AdSense through line item dynamic allocation. |
Label AdSense |
| Ad Exchange average eCPM The average effective cost-per-thousand-impressions earned from the ads delivered by Ad Exchange through line item dynamic allocation. |
Label Ad Exchange |
|
Total CTR
A percentage showing how often people who see your ad end up clicking it. Click-through rate (CTR) is total clicks, divided by total impressions, multiplied by 100. Total CTR is updated nightly and accounts for all impressions and clicks across Ad Manager, AdSense and Ad Exchange: Formula: (total clicks ∕ total impressions) ×ばつ 100 |
Label Total |
|
Ad server CTR
Percentage of impressions served by the Google Ad Manager server that resulted in users clicking on an ad. The clickthrough rate (CTR) is updated nightly. Formula: Ad server CTR = (Ad server clicks / Ad server impressions) x 100 |
Label Ad server |
|
AdSence CTR
The percentage of impressions served by AdSense that resulted in users clicking on an ad. The clickthrough rate (CTR) is updated nightly. Formula: (AdSense clicks ∕ AdSense impressions) ×ばつ 100 |
Label AdSense |
|
Ad Exchange CTR
The percentage of impressions served by the Ad Exchange that resulted in users clicking on an ad. The clickthrough rate (CTR) is updated nightly. Formula: (Ad Exchange clicks ∕ Ad Exchange impressions) ×ばつ 100 Note: The "Ad Exchange CTR" metric in Historical reports and the "CTR" metric in Ad Exchange historical reports are calculated differently, and they can't be compared. |
Label Ad Exchange |
Exceptions
There are some exceptions to the rules about compatibility.
Compatible with a subset of core dimensions
Some dimensions and metrics are compatible with a subset of the core dimensions, but not all of them.
| Dimensions | Compatible core dimensions |
|---|---|
| City, Region | Ad unit, Country, Date, Day of week, Demand channel, Device category, Inventory types, Month and year, Placement, Request type, Week |
| Bandwidth, Browser, Carrier, Metro, Operating system, Postal code, Targeting | Ad unit, Date, Day of week, Demand channel, Device category, Inventory types, Month and year, Placement, Request type, Week |
| Requested ad sizes | Ad unit, Creative size (delivered), Date, Day of week, Demand channel, Device category, Inventory types, Month and year, Placement, Request type, Week |
| Domain | Advertiser, Country, Date, Day of week, Demand channel, Device category, Inventory types, Line item, Line item type, Month and year, Order, Programmatic channel, Request type, Week |
| Total ad requests, Total fill rate, Total responses served, Total unmatched ad requests | Ad unit, Country, Date, Day of week, Device category, Month and year, Placement, Request type, Week |
Incompatible with some of the core dimensions
These dimensions and metrics are incompatible with some of the core dimensions.
| Dimensions & metrics | Reason for incompatibility |
|---|---|
| Unfilled impressions, Invoiced unfilled impressions, Unfilled competing impressions, Monetizable content views | Include unfilled event data, which has no delivery dimensions. Examples: Line item, Order, Advertiser, Creative size |
| Ad Exchange responses served, AdSense responses served, Ad server responses served, Total ad requests, Total responses served, Total unmatched ad requests, Total fill rate | Not compatible with delivery dimensions. Examples: Line item, Order, Advertiser, Creative size |
| Total code served count | Not available with Creative size (delivered). |
| Yield group callouts, Yield group successful responses | Not available with Creative size (delivered). |
| Yield group metrics, Mediation metrics | Not available with some delivery dimensions. |
| Targeted metrics | Require Key-values dimensions, which limits compatibility due to too many unique values. |
| Optimization metrics | Not compatible with inventory unit and creative dimensions (when used with the rest of the core dimensions). |
Incompatible with most core dimensions and metrics
Some dimensions are incompatible with most of the core dimensions and metrics, except for specific sets.
| Dimensions | Reason for incompatibility |
|---|---|
| Hour | Too many unique values. |
| Sales dimensions | Not applicable to any of the core metrics. |
| Position in pod, Position of pod, Fallback position, Content, Content bundle | Too many unique values. |
| Partner management dimensions | Not applicable to any of the core metrics. |
| Verified categories | Strict compatibility rules. |
| Activity, Activity group | Only compatible with conversion metrics. |
| Ad network name | Only compatible with Ad Exchange metrics. |
| Audience segment (billable) | Only compatible with reservation metrics. |
| Custom event | Only compatible with Rich Media metrics. |
| Key-values | Too many unique values. |