Dimensions and metrics help you interpret data generated from your Query Tool reports at a more granular level. Described are available dimensions and metrics, along with their definitions.
Report dimensions
Time dimensions
| Dimension | Description | Filterable |
|---|---|---|
| Month | Activity by month. Can also be shown as a range. | No |
| Week | Activity by week. Can also be shown as a range. | No |
| Day | Activity by day. Can also be shown as a range. | No |
| Hour | Activity by hour. Can also be shown as a range. | No |
Buyer-specific timezones
All buyers see two time zones the Query Tool - Pacific and UTC. Buyers outside of the Pacific time zone will see Pacific, UTC, and the buyer’s local timezone.
Note: UTC is fully supported for reports, starting with December 1, 2024. Earlier dates can't be selected.
Inventory dimensions
| Dimension | Description | Filterable |
|---|---|---|
| Country | Shows the countries where users viewed ads on the publisher’s inventory. | Yes |
| Creative format | Shows the format of the creative served. | Yes |
| Mobile app ID | Shows the mobile app IDs on which mobile App impressions are served. | Yes |
| Mobile app name | Shows the mobile app names (from the iTunes app store or Google Play store) on which mobile app impressions are served (e.g., “The Best App”). | Yes |
| Platform | Displays the different types of devices and platforms (for example, desktop computer, a high-end mobile device or another mobile device) that advertisers serve ads on. | Yes |
| Publisher domain | Shows data for publisher domains and subdomains. | Yes |
| Web property name | Shows the seller names associated with the seller accounts for the pages on which ads are served. | Yes |
| Publisher name | The name of the publisher as it is known to Google. | Yes |
| Publisher ID | The ID used to identify the publisher on Google's sell-side platform. This is identical to the ID present in the publisher's ads.txt or app-ads.txt file. | Yes |
| Buyer SDK | Shows if ads are rendered with a buyer provided SDK. | Yes |
| GMA SDK | Shows if ads are rendered with the Google Mobile Ads SDK. | Yes |
Demand dimensions
| Dimension | Description | Filterable |
|---|---|---|
| Advertiser | Shows which advertisers transacted on publisher inventory and for how much. | Yes |
| Bid filtering reason | Shows reason why a bid was filtered. | Yes |
| Billing ID | Shows the billing ID used to transact on publisher inventory. | Yes |
| Buyer account ID | Shows which buyers (account ID) transacted on publisher inventory. | Yes |
| Buyer account name | Shows which buyers (account name) transacted on publisher inventory. | Yes |
| Buyer reporting ID | Shows which buyers (reporting ID) transacted on publisher inventory. | Yes |
| Creative ID | Shows the buyer creative ID assigned to each creative. | No |
| Creative size |
Shows the actual winning ad size of the creative. Here are additional creative size labels:
|
Yes |
| Delivered by Protected Audience API |
Shows impressions won by bids from Protected Audience interest groups. Learn more about the Protected Audience API. Note: This dimension is only supported for impression metrics; bid metrics are not supported. |
Yes |
| VAST error code | Displays the VAST error code. | Yes |
Deal dimensions
| Dimension | Description | Filterable |
|---|---|---|
| Deal ID | Shows the performance breakdown of Preferred Deals, Private Auctions, and Programmatic Guaranteed deals, broken out by deal ID. The deal ID is a system-generated number used to identify a deal between a buyer and a publisher. The ID is included in all bid requests that are passed as part of Preferred Deals, Private Auctions, and Programmatic Guaranteed deals. | Yes |
| Deal name | Shows the performance of Preferred Deals, broken out by a deal name. | Yes |
| Transaction type | Shows the transaction/auction type of the ad (Open auction, private auction, preferred deal, programmatic reservation). | Yes |
| Cost type | Shows the cost type of the ad (CPM or CPD). | Yes |
Report metrics
Bid metrics
| Metric | Description |
|---|---|
| Inventory matches | The total number of potential queries based on your pretargeting settings. |
| Bid requests | The total number of bid requests sent to the bidder. |
| Successful responses | The total number of properly formed bid responses received by our servers within 100 ms. |
| Bids | The total number of bids received from the bidder. |
| Bids in auction | The total number of bids that passed through all filters and competed in the auction. |
| Auctions won | The total number of impressions the bidder won. |
| Bid filtering opportunity cost (Bidder currency) | The additional amount the bidder would transact if the bids with this creative were not filtered. Examples include, due to publisher controls and policies in the bidder's currency. |
| Bid filtering opportunity cost (Buyer currency) | The additional amount the bidder would transact if the bids with this creative were not filtered. Examples include, due to publisher controls and policies, in the buyer's currency. |
Impression metrics
| Metric | Description |
|---|---|
| Reached queries | The total number of ad queries on which your bidder won both the real-time auction and the mediation chain. For queries that participated in mediation, reached queries equals the total number of times your bidder won in mediation. For queries that did not participate in mediation, reached queries equals auctions won. Learn more about Mediation. |
| Impressions | The count of ads which are served to a user
In the context of video, this metric measures the number of video ads actually recorded as "viewed" or showing the first frame of the video ad, not showing the ad to completion. Ad impressions are often less than matched requests because in some cases, matched requests may include video ads that never show the first frame (for example, due to an ad serving error or some other technical issue).
|
| Clicks | The number of times a user clicked on an ad |
| Active view measurable | Impressions (out of all eligible impressions) that can be measured by Active View |
| Active view viewable | Impressions (out of all measurable impressions that were considered viewable based on MRC standards) that can be viewed |
| Active view viewability rate |
Active View viewability rate is the ratio of Viewable impressions to Measurable impressions Active View viewability rate = Viewable impressions / Measurable impressions |
| Spend (bidder currency) | Cost of the ad impression, or daily cost for CPD deals (in the bidder's currency) |
| Spend (buyer currency) | Cost of the ad impression, or daily cost for CPD deals (in the buyer's currency) |
| CPM (bidder currency) |
Cost per thousand impressions. (in the bidder's currency) CPM = (Cost / Ad impressions) * 1000 |
| CPM (buyer currency) |
Cost per thousand impressions. (in the buyer's currency) CPM = (Cost / Ad impressions) * 1000 |
| CPC (bidder currency) | The cost-per-click (CPC) is the average amount you pay each time a user clicks on your ad. (in the bidder's currency) |
| CPC (buyer currency) | The cost-per-click (CPC) is the average amount you pay each time a user clicks on your ad. (in the buyer's currency) |
Video viewership metrics
| Metric | Description |
|---|---|
| Video start | Displays a count of how many times the video ad started playing. |
| Video reached first quartile | Measures the effectiveness of video ads by determining what percentage of a given video was played. Ad Exchange for Video displays a count of how many times the first 25% (Quartile 1) of a video ad has been played. |
| Video reached midpoint | Measures the effectiveness of video ads by determining what percentage of a given video was viewed by a user. Ad Exchange for Video displays a count of how many users have seen 50% (Midpoint) of a video ad. |
| Video reached third quartile | Measures the effectiveness of video ads by determining what percentage of a given video was played. Ad Exchange for Video displays a count of how many times the first 75% (Quartile 3) of a video ad has been played. |
| Video completions | Displays a count of how many times 100% of a video ad has been played. |
| VAST error count | Displays a count of how many VAST errors occurred during a video ad. |
| Engaged views | Number of times a skippable video ad has been viewed to completion or watched to 30 seconds, whichever happens first. |
| View-through rate |
View-through rate is the ratio of engaged views to skippable impressions. View-through rate = Engaged views / Skippable ad impressions. |
Cost transparency metrics
| Metric | Description |
|---|---|
| Raw impressions | Number of impression pings from user devices. |
| Deduplicated impressions | Number of deduplicated impression pings. |
| Cost of deduplicated impressions (bidder currency) | The cost corresponding to deduplicated impressions. (in the bidder's currency) |
| Cost of deduplicated impressions (buyer currency) | The cost corresponding to deduplicated impressions. (in the buyer's currency) |
| Pre-filtered impressions | Number of invalid impressions pre-filtered near real time that were not billed for (online spam). |
| Cost of pre-filtered impressions (bidder currency) | The cost of invalid impressions pre-filtered in near real time that were not billed for (online spam). (in the bidder's currency) |
| Cost of pre-filtered impressions (buyer currency) | The cost of invalid impressions pre-filtered in near real time that were not billed for (online spam). (in the buyer's currency) |
| Impressions net of pre-filtering | Top-line number of impressions that appears in the invoice, which excludes IVT pre-filtered impressions. |
| Cost net of pre-filtering (bidder currency) | Top-line cost that appears in the invoice, which excludes IVT pre-filtered cost. (in the bidder's currency) |
| Cost net of pre-filtering (buyer currency) | Top-line cost that appears in the invoice, which excludes IVT pre-filtered cost. (in the buyer's currency) |
| IVT credited impressions | The number of impressions detected to be invalid after serving that were then credited back to your account (offline spam). |
| Cost of IVT credited impressions (bidder currency) | The cost of invalid impressions detected to be invalid after serving that were then credited back to your account (offline spam). (in the bidder's currency) |
| Cost of IVT credited impressions (buyer currency) | The cost of invalid impressions detected to be invalid after serving that were credited back to your account (offline spam). (in the buyer's currency) |
| Billed impressions | Bottom-line impression count after removing all spam-related impression credits. |
| Cost of billed impressions (bidder currency) | Bottom-line cost that appears in the invoice, which excludes both online and offline spam filtering. (in the bidder's currency) |
| Cost of billed impressions (buyer currency) | Bottom-line cost that appears in the invoice, which excludes both online and offline spam filtering. (in the buyer's currency) |
Certain dimensions and metrics are incompatible with other dimensions or metrics. These appear disabled with an alert icon displayed to the right. When you hover over the icon, you are advised that if you want to include the metric in your report, something should be removed. Additionally, if you wish to only see compatible metrics in your view, you can press the three dots next to the search bar and toggle ‘Show incompatible’ on or off.
Request other data
If you still have questions about the data available to you and/or how to access the data, please use this form.