Today, we’re announcing the v24 release of the Google Ads API . To use the new v24 features, 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 , our Ads Developers YouTube Live , or our LinkedIn Live event tomorrow (April 23rd at 10a 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
Support for Conversions with Cart Data: Conversions with cart data is an extension to conversion tracking on your website or app. Using conversions with cart data, you can provide the details of products sold for each transaction, which helps you unlock advanced sales, profit reporting, and insights for your Google Ads account and campaigns, such as number of orders, average cart size, revenue and gross profit.
Google Ads API v24 adds support for this feature as follows:
Added a new resource CartDataSalesView product_sold_brand Added several “all” non-biddable metrics, which are metrics that also include the conversions your campaigns are not actively optimizing towards, for example all_cost_of_goods_sold_micros Added the conversion_attribution_event_type ShoppingPerformanceView
Updated features
Version v24 introduces updates to existing features that require code changes when upgrading. We cover the most important ones here; check out the release notes for the full list of changes .
Video content exclusion settings in campaigns: We simplified the ability to set video content exclusion settings on individual campaigns . This setting is available at the customer level , and applies to all the campaigns instead. These content exclusion settings are meant to give you additional control and help you exclude types of content that, while in compliance with our policies, may not fit your brand or business. See https://support.google.com/google-ads/answer/7515513 to learn more about video content exclusion settings.
Changes to AudienceInsightsService: As part of a code refactoring, we moved the InsightsAudience.topic_audience_combinations common namespace. You may need to update your import directives in some programming languages.
Changes to ReachPlanService: As part of a code refactoring, we moved the youtube_select_lineups field from the ReachPlanService.ListPlannableProducts youtube_select_lineup_targeting reservation products for eligible clients to target among the top 1% of popular channels on YouTube with the most passionate audiences in a given market. Learn more .
Changes to ContentCreatorInsightsService: As part of a code refactoring, we removed the is_brand_connect_creator field from the ContentCreatorInsightsService.GenerateCreatorInsights ContentCreatorInsightsService.GenerateTrendingInsights CREATOR_PARTNERSHIPS partnership_opportunities Learn more .
Changes to KeywordPlanIdeaService: To provide a more streamlined and reliable experience, we have unified our forecasting infrastructure. Google Ads API v24 introduces an updated GenerateKeywordForecastMetrics
Changes to campaign_budget resource: We removed the ad_sub_network_type segment for the campaign_budget
Changes to asset views: We removed the click_type segment from the ad_group_asset campaign_asset customer_asset click_type ad_group_ad resource to get details on the ad performance and the asset it was served with.
Changes to video responsive ad: VideoResponsiveAdInfo is now mutable. As part of this change, we have marked videos, business_name and logo_images as required fields in both the DemandGenVideoResponsiveAdInfo VideoResponsiveAdInfo
Changes to ShareablePreviewService: Updated ShareablePreviewService.GenerateShareablePreviews Learn more .
The following resources can help you get started:
For technical support issues, reach out to https://support.google.com/google-ads/contact/google_ads_api
Anash P. Oommen , Google Ads API Team
