To reduce complexity and provide better support, we occasionally retire dimensions, metrics, and report types. Details about what's changing, and what to use as a replacement, are listed in the table below.
Watch the "Coming soon" section of our biweekly release notes for regular communications about any scheduled deprecation or deletion. Relevant items will also be labeled "deprecated" or "discontinued" in the product interface, but not officially removed until the date announced in the release notes.
-
Deprecated: This dimension or metric will be removed from the Ad Manager UI in the future. You're encouraged to use alternative dimensions or metrics instead.
-
Discontinued: This dimension or metric can no longer be used in reports and will be removed from the Ad Manager UI soon.
Upcoming retirements
Deprecation of Privacy Sandbox API dimensions
In April, 2025, Chrome announced plans to maintain our current approach of offering users third-party cookie choices.
We have since retired most Privacy Sandbox technology, including the Protected Audience and Topics APIs.
We'll remove the following deprecated dimensions from Ad Manager reporting:
- "Protected Audience seller (non-Google)"
- "Protected Audience API delivery"
- "Topics status"
Deprecation of "Video line item" filterDue to the migration to QTI, we’ll remove an implicit video line item filter for dimensions related to video position and pod position. The impact for existing reports may be a higher number of "Unknown" values, especially when the recorded event is associated with a display event.
Publishers can filter specifically for video line items using 'Line Item Environment Type = Video Player'.
Deprecation of the "Creative size" dimensionInstead, use the "Rendered Creative Size" dimension.
Deprecation of the "Devices" dimensionThe "Devices" dimension will be deprecated in 2026. Instead, use the "Device model" and "Device manufacturer" dimensions, which provide richer device information. In addition, "Device category" and "Operating System Category" dimensions provide higher-level device groupings.
The Video creative quality report is deprecated and will be removed as part of the upcoming "Reports" deprecation in 2026.
Deprecation of the "Analytics" report
The Analytics
report is deprecated and will be removed as part of the upcoming "Reports" deprecation in 2026. Analytics dimensions and metrics are available as part of "Historical" reports in Interactive reports.
The Total optimization lift (%) metric has been deprecated in the Reports tool and will be removed from Ad Manager in early 2026. This metric became irrelevant in 2019 after the transition to first-price auction.
Recent retirements
Deprecation of the "Technical ad delivery" reportThe Technical ad delivery report is deprecated and will be removed from the Ad Manager interface in October 2025. Please download any data you want to save by the end of September 2025.
As an alternative to Technical ad delivery, consider using Limited ads .
In Ad Manager "Reporting," the Reports tool is deprecated and will be removed from the Ad Manager interface in early 2026. It will be superseded by Interactive reports , which offers an enhanced reporting experience and is now available to all Ad Manager publishers. Learn more about the migration to Interactive reports .
Deprecation of reporting metricsGoogle Ad Manager is ending support for metrics, dimensions and attributes with low usage or related to obsolete products. These fields will be labeled as deprecated in the Reporting UI and API and removed after a limited grace period.
The following Dynamic allocation opportunity metrics are to be removed:
- Impressions competing
- Eligible impressions
- Impressions not competing
- Impressions not competing (%)
- Dynamic allocation saturation rate
- Dynamic allocation match rate
- Unfilled competing impressions
Deprecation of reporting metricsThe Optimization metrics are no longer supported.
Deprecation of reporting metricsThe following metrics are no longer supported based on the introduction of Yield groups. Use "Yield group" as an alternative. The following metrics are removed:
- SDK mediation creative clicks
- SDK mediation creative impressions
Google Ad Manager is ending support for metrics, dimensions and attributes with low usage or related to obsolete products. These fields will be labeled as deprecated in the Reporting UI and API and removed after a limited grace period. The following metrics/dimensions are to be removed:
- PPID presence
- User identifier status
- Buying agency
Google Ad Manager is ending support for metrics, dimensions and attributes with low usage or related to obsolete products. These fields will be labeled as deprecated in the Reporting UI and API and removed after a limited grace period. The following metrics/dimensions are to be removed:
- Mediation third-party impressions
- Mediation third-party revenue
- Total Multiplex cell impressions
- TCF vendor
- TCF vendor ID
- Ad server CPF revenue
- Partner label
On February 22, 2024, Ad Manager will end support for Spotlight activities and conversions as part of the third-party cookies phased deprecation. Activity tags, activity groups, CPA line items, and the Data Transfer NetworkActivities file will no longer serve after this date (historical data will be available for several months). For details on Spotlight, visit Activities and conversions .
Labeled: May 2022Announced: May 2022
Report type retiring: Ad Exchange historical report
Replacement:
This report has been deprecated
.
Use the Historical report
instead.
Announced: May 2018
Data protection
Metric retiring:
Ad Exchange historical Video abandonment rate
Replacement:
This metric has been deprecated
.
Use a Historical report to calculate video abandonment rate
.
Announced: September 2019
Metrics retiring: The "Reach" metrics family, including:
Reach Average impressions / visitor
Reach Average revenue / visitor
Reach Unique visitors
Replacement:
For Ad Manager 360 users, use the new Reach report
and the new "Unique reach" metrics family.
Announced: June 2019
Report type retiring:Bid Landscape report
You may run the report to view historical data for up to six months after deprecation.
Announced: July 2018
Report type retiring:Yield report
Replacement:
Use your new Overview home dashboard's demand comparison
.
Announced: November 2018
Metric retiring:
HistoricalAd server downloaded impressions
Replacement:
This metric has been discontinued
.
Use the Ad server impressions metric
.
Announced: May 2018
Dimension retiring:Yield partner type
Replacement:
Use the Demand channel
dimension.
Announced: May 2018
Dimension retiring:Creative size
Replacement:
Use the Creative size (delivered)
dimension.
Announced: March 2018
Business intelligence
Replacement:
Use the "Historical" report type.
Announced: January 2018
Dimensions retired:
Verified advertiser
Verified brand
May 4, 2018
Announced: October 2017
Ad server
Replacement:
Combine the Demand channel dimension and the Total code served count metric.
Announced: October 2017
Dimension retired:Ad request size
Replacement:
Use the Requested ad sizes
dimension.
Announced: October 2017
Total
Replacement:
Use the Delivery indicator attribute of the Line item dimension.
Announced: October 2017
Partner Management
Partner Management
Partner Management
Partner Management
Replacement:
Use the Partner finance report type. These metrics will only be removed from the Historical report type.
Announced: October 2017
Dimension retired:
Delivery Aggregated demand channel
Replacement:
Use the Demand channel
dimension.
Announced: October 2017
Dimensions retired:
Mediation Mediation group
Mediation Mediation network
Mediation Mediation network tag
Replacement:
Use Yield group reporting
.
Announced: October 2017
Metrics retired:The "Mediation" metrics family, including:
Mediation Mediation impressions
Mediation Mediation estimated revenue
Mediation Mediation estimated CPM
Mediation Mediation fill rate
Mediation Mediation passbacks
Mediation Mediation third-party eCPM
Mediation Mediation served requests
Replacement:
Use Yield group reporting
.
Ad server
