Today we are announcing the release of v25.1 of the Google Ads API . To use the new capabilities, you must upgrade your client libraries and client code. All the updated client libraries and code examples have been published.
Come join us for a live walkthrough of this release in our "Google Ads API Release Highlights" event on Discord or our Ads Developers YouTube Live tomorrow (August 20th at 10am ET). This will also be recorded and posted on YouTube for those who can’t make the live events. If you have any questions or want to discuss this post, reach out to us in the #ads-api channel on Discord.
New Features
Here are the highlights of what’s new in v25.1:
Conversion lift and brand lift measurement : We've added comprehensive support for lift studies in the API. Read-only resources LiftMeasurementConfig LiftMeasurementFlight LiftMeasurementAgeRange LiftMeasurementCampaign LiftMeasurementDevice LiftMeasurementGender LiftMeasurementVideo Brand lift and Conversion lift . Both these features are available only to allowlisted Google Ads accounts. To use these features, contact your Google account representative.
BenchmarksService category scoping and new metrics : You can now scope your benchmark analysis against advertisers in specific Product & Service Categories using the new category_filter BenchmarksService.GenerateBenchmarksMetrics ListBenchmarksSources share_of_voice are now surfaced via AggregateMetrics ShareMetrics Brand Sentiment Insights : ContentCreatorInsightsService BrandSentimentInsight Loyalty Program Segmentation and Conversion Value Rules : You can now segment report metrics by the loyalty program tier of converting users using Segments.loyalty_membership LOYALTY_MEMBERSHIP ConversionValueRulePrimaryDimension allows you to track when a loyalty membership condition was satisfied for a conversion value rule.
Original Conversion Value Metric : The new Metrics.original_conversion_value Parental Status Targeting in Reach Planning : ReachPlanService parental_statuses targeting within Targeting PlannableTargeting
Getting Started
Google Ads API v25.1 is a drop-in upgrade for v25. If you use our client libraries, download the latest version of your client library to start using these features. For a full list of changes, please review the official release notes . If you have any questions or want to discuss this post, please reach out to us on our “Google Advertising and Measurement Community” Discord server .
For technical support issues, please reach out to the Google Ads API support channel .
Anash P. Oommen , Google Ads API Team
