Google Ads API v24 Released Upgrade Client Libraries for New Features

The Google Ads API v24 release introduces new features and updates requiring client library and code upgrades. The updated client libraries and code examples are available, and a live walkthrough event is scheduled for April 23rd, with recordings accessible afterward.

New Features

• Support for Conversions with Cart Data:
  This feature extends conversion tracking by including product details sold per transaction, enabling advanced sales and profit reporting.
  Key additions include:
  • A new resource, CartDataSalesView, allowing segmentation of conversion metrics by products sold, such as product_sold_brand.
  • New “all” non-biddable metrics like all_cost_of_goods_sold_micros that include conversions not actively optimized by campaigns.
  • The conversion_attribution_event_type segment added to ShoppingPerformanceView to differentiate conversions attributed to clicks or views, essential for cart data stats.

Updated Features

• Video Content Exclusion Settings:
  Simplified to apply at the customer level instead of individual campaigns, providing better control over excluding certain video content types.
• AudienceInsightsService:
  The InsightsAudience.topic_audience_combinations field moved to the common namespace, requiring import updates in some languages.
• ReachPlanService:
  The youtube_select_lineups field moved to youtube_select_lineup_targeting. YouTube Select Lineups are reservation products targeting top YouTube channels with engaged audiences.
• ContentCreatorInsightsService:
  The is_brand_connect_creator field removed; users should now check for CREATOR_PARTNERSHIPS in partnership_opportunities to find YouTube creator partnerships.
• KeywordPlanIdeaService:
  Introduced an updated GenerateKeywordForecastMetrics method to streamline forecasting by focusing on key performance metrics.
• Campaign Budget Resource:
  Removed the ad_sub_network_type segment due to incompatibility.
• Asset Views:
  The click_type segment removed from ad_group_asset, campaign_asset, and customer_asset views to align with product changes; use click_type from ad_group_ad for ad performance details.
• Video Responsive Ad:
  VideoResponsiveAdInfo is now mutable; videos, business_name, and logo_images are required fields in DemandGenVideoResponsiveAdInfo and VideoResponsiveAdInfo.
• ShareablePreviewService:
  Updated GenerateShareablePreviews to disallow partial failures; requests will throw errors if any ID fails.

Additional Resources and Support

• Release notes, upgrade guides, references, and a diff between v24 and v23 are available for developers.
• Technical support can be accessed via the Google Ads API support page.

The release aims to enhance conversion tracking, simplify campaign settings, and improve forecasting and insights, requiring developers to update their implementations accordingly.