Google Ads API v24 release

Google has officially announced the release of Google Ads API v24. This update introduces enhanced sales analytics functionality, optimizes video content management, and refactors the architecture of specific services. To access these new features, developers must upgrade their client libraries and adapt existing codebase.

Conversions with cart data

The most significant addition in v24 is the expanded support for Conversions with Cart Data. This tool allows for more granular conversion reporting by including information about specific products sold in each transaction.

• CartDataSalesView Resource: Enables the segmentation of conversion metrics by product attributes (e.g., by brand — product_sold_brand).
• New Metrics: Introduced a group of “all” (non-biddable) metrics, such as all_cost_of_goods_sold_micros. these reflect data even for conversions not actively used for bidding strategy optimization.
• ShoppingPerformanceView Segmentation: Added the conversion_attribution_event_type field, allowing users to distinguish between conversions resulting from clicks versus views.

Service updates and structural changes

Version v24 includes refactoring of several core services to improve operational efficiency:

Video Content Settings

• Content Exclusions: Settings for excluding certain types of video content are now applied at the customer level rather than the campaign level, simplifying global brand safety management.
• Video Responsive Ads: The VideoResponsiveAdInfo object is now mutable. Fields for “video,” “business name,” and “logos” are now mandatory.

Audiences and Reach

• AudienceInsightsService: The InsightsAudience.topic_audience_combinations field has been moved to the common namespace, requiring updates to code imports.
• ReachPlanService: The youtube_select_lineups field has been replaced by youtube_select_lineup_targeting for accessing premium YouTube Select inventory.
• ContentCreatorInsightsService: The is_brand_connect_creator field was removed. To identify creator partnerships, use the CREATOR_PARTNERSHIPS parameter within the partnership_opportunities field.

Planning and Forecasting

• KeywordPlanIdeaService: Introduced the GenerateKeywordForecastMetrics method, which streamlines the forecasting process by focusing on key performance indicators.

Reporting changes and constraints

To align the API with current product updates, the following adjustments have been made:

• Campaign Budget: The ad_sub_network_type segment has been removed due to technical incompatibility.
• Assets: The click_type segment was removed from ad_group_asset, campaign_asset, and customer_asset views. For click type analysis, it is recommended to use ad_group_ad.
• ShareablePreviewService: The GenerateShareablePreviews method no longer supports partial failures. If any ID in a request is invalid, the system will return an error for the entire request.

Implementation recommendations and deadlines

To ensure business process stability, it is recommended to follow this migration plan:

1. Reporting Audit: Due to the removal of the click_type segment from Asset levels, internal CRM systems and Looker Studio dashboards using this data must be reconfigured to pull from the ad_group_ad level immediately.
2. Technical Markup Verification: Leveraging CartDataSalesView requires the correct transmission of cart data from the website. A technical audit of Google Tag Manager settings is recommended to ensure synchronization with the new API methods.
3. Upgrade Timeline: Given the standard lifecycle of Google Ads API versions, developers and technical specialists should aim to complete the migration to v24 within the current quarter to avoid risks associated with the sunsetting of previous versions.

Professional support and consulting

Implementing Google Ads API v24 updates requires not only technical code adjustments but also deep expertise in end-to-end analytics configuration. Our team at UAMASTER is ready to provide full support for your business during the transition to these new reporting standards:

• Comprehensive Analytics Audit: We will help verify the accuracy of cart data transmission via Google Tag Manager, which is critical for activating new sales and brand reporting features.
• Conversion Rate Optimization (CRO) & Profitability Strategy: Our experts will help integrate new COGS (cost of goods sold) metrics into your dashboards, transforming reports from “clicks and leads” into concrete data on net profit and margins.
• Ad Campaign Adaptation: We will ensure your Demand Gen and video campaigns are reviewed and updated to meet Google’s new requirements, guaranteeing the seamless operation of all assets.
• Custom Report Configuration: If your internal reporting systems or Looker Studio dashboards were affected by structural changes in segmentation, we will promptly reconfigure them to maintain data continuity.

Contact us for a consultation to turn technical API updates into a strategic advantage for your marketing.

Read this article in Ukrainian.