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 and LiftMeasurementFlight allow you to inspect study configurations, flight dates, campaign details, and conversion goals. This release includes 24 new Conversion Lift metrics and winner score metrics for statistical analysis, as well as new Brand Lift dimension resources: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender, and LiftMeasurementVideo. Refer to our help center article to learn more about 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 parameter in BenchmarksService.GenerateBenchmarksMetrics. Supported categories can be discovered via ListBenchmarksSources. In addition, new customer ad metrics (aggregate cost, views) and share metrics such as share_of_voice are now surfaced via AggregateMetrics and ShareMetrics.
• Brand Sentiment Insights: ContentCreatorInsightsService now supports brand sentiment data, allowing you to retrieve sentiment distributions and summaries for creators and brands via 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. Additionally, the new LOYALTY_MEMBERSHIP primary dimension in 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 metric surfaces the unadjusted conversion value from biddable conversions before any conversion value rules or customer lifecycle goal adjustments are applied.
• Parental Status Targeting in Reach Planning: ReachPlanService now supports parental_statuses targeting within Targeting and PlannableTargeting for reach forecasting and plannable product discovery.

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