Release Notes

v20 (2025-06-04)

The following new features and updates were added in v20.

Assets

Added several new metrics and segment columns for the asset_group report.

Metrics columns

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• conversions_by_conversion_date
• all_conversions_by_conversion_date
• conversions_value_by_conversion_date
• all_conversions_value_by_conversion_date
• value_per_conversions_by_conversion_date
• value_per_all_conversions_by_conversion_date

Segment columns

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

Campaigns

• Added support for adding and updating campaign-level negative keywords for Performance Max campaigns.

Conversions

• You can now update the google_ads_conversion_customer field on an existing customer to opt in to cross-account conversion tracking, or to change its existing conversion tracking parent to a different manager account.

• Added the ClickConversion.user_ip_address field. Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Please add logic to conditionally exclude sharing IP addresses from users from these regions. Make sure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the About offline conversion imports page for more details.

Demand Gen

• Added new values to the ad_network_type segment that allow segmenting Demand Gen campaigns by channel:
  • MAPS
  • GMAIL
  • DISCOVER
• Added metrics for platform-comparable conversions:
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
  • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

Recommendations

• Added the merchant_center_account_id field to GenerateRecommendationsRequest to indicate when recommendations should be generated for retail, rather than the standard Performance Max campaigns.

Planning

• Added AudienceInsightsDimension.YOUTUBE_LINEUP to replace AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP in AudienceInsightsService and ContentCreatorInsightsService. This new dimension lets you retrieve insights and metadata for YouTube Select (YTS) Lineups. Replaced objects associated with YOUTUBE_DYNAMIC_LINEUP such as DynamicLineupAttributeMetadata and the AudienceInsightsDynamicLineup to align with the broader removal of Dynamic Lineups across Google Ads. This feature is only available to accounts on an allowlist.
• Added AdditionalApplicationInfo and ApplicationInstance in the AudienceInsightsService, ContentCreatorInsightsService, and ReachPlanService. This feature is only available to accounts on an allowlist.
• Updated AudienceInsightsService and ContentCreatorInsightsService to provide more detailed insights. You can now segment content creator data by device using the new AudienceInsightsDimension.DEVICE and AudienceInsightsAttribute.device in both services. This feature is only available to accounts on an allowlist.
• Added additional aggregated video metrics to GenerateCreatorInsightsResponse for more comprehensive content creator analysis: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count, and is_brand_connect_creator. This feature is only available to accounts on an allowlist.
• Added sub_country_locations to GenerateCreatorInsightsRequest for the ContentCreatorInsightsService. This allows specifying sub-country geographic locations to refine searches for creator insights. The sub_country_locations field is only supported when using the search_attributes oneof in the criteria field. If sub_country_locations are provided with other criteria types, the request will be invalid. This enables more granular geographical targeting and analysis for content creator insights. This feature is only available to accounts on an allowlist.
• Added ReachPlanService.ListPlannableUserLists, which returns first-party user lists owned by a customer, and added UserListInfo to the audience targeting options in GenerateReachForecastRequest. This lets you retrieve plannable user lists for a given customer and then generate reach forecasts for campaigns targeting those specific audiences. These enhancements improve tailored reach planning by incorporating your first-party audience data directly into forecasting. Reach forecasting is available to allowlisted accounts only.

Videos

• Added AdFormatType.PAUSE ads served on organic YouTube videos on TV screens, which is included in reporting. These ads are displayed directly next to the static video frame on the pause screen. This does not include Demand Gen video ads displayed on the ad panel below or on top of a paused organic video, which are reported under AdFormatType.INFEED.

v19.1 (2025-04-16)

The following features and changes were added in v19.1.

Assets

• Added an asset_coverage field for AssetGroup that returns information about gaps in your asset group.
  • Contains a subfield ad_strength_action_items which returns a list of actions that an advertiser can take to improve the ad strength of an asset group.

Campaigns

• You can now rate or provide feedback for leads in Local Service Campaigns. As part of this change, v19.1
  • Added a new service named LocalServicesLeadService. You can use the ProvideLeadFeedback method to upload rating and feedback for leads.
  • Added a new field named lead_feedback_submitted to LocalServicesLead to help determine if feedback was submitted to a lead.
• Added a new metric column biddable_cohort_app_post_install_conversions for App campaigns.

Demand Gen

• Additional methods were introduced in the Planning services to support Demand Gen.

• Added support for AdGroup-level Channel Controls for Demand Gen campaigns. You can select a predefined general grouping of channels, or a subset of channels using the demand_gen_ad_group_settings field. The following channels are supported in the current release:

  • YouTube In-Stream
  • YouTube In-Feed
  • YouTube Shorts
  • Discover
  • Gmail
  • Display

• Exposed a new asset type for TALL_PORTRAIT_MARKETING_IMAGE. This asset type relates to the tall_portrait_marketing_images field of the Demand Gen Multi Asset Ad format.

Change History

• Added support for three more resource types into ChangeStatusResourceType:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• You can retrieve these three finer-grained types from the change_status report.

Conversions

• You can now set the google_ads_conversion_customer field while creating a new customer using the Google Ads API. This was previously a read-only field.
• You can now specify the type of the customer associated with the conversion when uploading offline conversions.
• A new session_attributes field was introduced for ClickConversion.

Local Services Ads

• Added a new RPC ProvideLeadFeedback to LocalServicesLeadService to provide feedback on the quality of LocalServicesLead.
• Added a new field lead_feedback_submitted to the LocalServicesLead resource that confirms if feedback was provided for a specific resource.

Planning services

• Added support for Target frequency monthly forecasts in ReachPlanService.GenerateReachForecast.
  • Developers can set TargetFrequencyTimeUnit.MONTHLY in TargetFrequencySettings when using the TARGET_FREQUENCY plannable product code to generate a Target frequency monthly reach forecast.
• Added a new method ReachPlanService.GenerateConversionRates, which allows advertisers to request suggested conversion rates for supported plannable products.
• Demand Gen forecasting in ReachPlanService.GenerateReachForecast:
  • Developers can now request reach forecasts for Demand Gen campaigns. Developers can use the new DEMAND_GEN_MAX_CONVERSIONS plannable product code to generate Demand Gen reach forecasts.
  • Added a new conversion_rate field that allows developers requesting Demand Gen reach forecasts to provide a conversion rate. Suggested conversion rates can be retrieved using the new ReachPlanService.GenerateConversionRates method. This field is required for Demand Gen forecasting requests. It is not supported for other plannable products.
  • Added a new conversions field to returned forecasts. This field contains the number of conversions at a given point on the reach curve. Conversions are only supported for the DEMAND_GEN_MAX_CONVERSIONS plannable product.

Recommendations

• The new ad_strength field is available for ImprovePerformanceMaxAdStrengthRecommendation, which returns the current ad strength score of the asset group associated with the recommendation.

Shopping

• You can now override brand exclusions for Shopping ads in Performance Max campaigns. This is exposed through a new pmax_campaign_settings field at the campaign level, and it works only for PMax campaigns for Retail. A new CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED error will be thrown if you attempt to set this field for an incompatible campaign type.

Videos

• Added read-only support for Audio Ads. See Google Ads Help Center to learn about this feature. This changes exposes:
  • A new AdvertisingChannelSubType named YOUTUBE_AUDIO.
  • A new AdGroupType named YOUTUBE_AUDIO.
  • A new ad format enumeration named YOUTUBE_AUDIO_AD, and its corresponding YouTubeAudioAdInfo fields.
• Added new metrics and segments to query reach metrics with demo adjustment. As part of these changes,
  • Two new metrics columns named coviewed_impressions and primary_impressions were introduced.
  • Two new segments named adjusted_age_range and adjusted_gender were introduced.
  • If either of the two new segments are selected alongside a reach metric field (coviewed_impressions, primary_impressions, unique_users, or average_impression_frequency_per_user), the other segment must be selected as well to retrieve valid stats for these columns.
  • This feature is currently available only for allowlisted customers.

v19 (2025-02-26)

The following features and changes were added in v19.

Account Management

• Added the following values to CustomerError to account for upcoming changes:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Ads

• Added DemandGenMultiAssetAdInfo.tall_portrait_marketing_images to support portrait image assets with aspect ratio 9:16 in Demand Gen ads.

Assets

• (For allowlisted accounts only) Added support for message assets through Asset.business_message_asset, BusinessMessageAsset and the following enums and errors.
  • Enums:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Errors:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• Added AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW to support automatically generating a landing page preview.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS is now opted-in by default for Demand Gen video responsive ads.
• (For allowlisted accounts only; allowlist is currently closed) Added Asset.app_deep_link_asset and AppDeepLinkAsset.

Conversions

• Conversion goals
  • LifecycleGoalValueSettings.high_lifetime_value is out of beta and now mutable.
  • Added CustomerLifecycleGoal.owner_customer to show the resource name of the customer which owns the customer lifecycle goal.
• Deprecated ConversionActionType.SALESFORCE.

Feeds

• Removed all feed-related entities, such as Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, etc. Users should now use assets to achieve the same purpose. Visit Migration Notes for the list of all removed entities.

Hotel & Travel

• Made min_days and max_days of ValueRuleItineraryAdvanceBookingWindow an optional field to allow specifying 0 as a value. This supports targeting for travel searches that happen today.

Performance Max

• (For allowlisted accounts only) Brand guidelines
  • Made Campaign.brand_guidelines_enabled mutable only when creating a Performance Max campaign.
  • This is incompatible with Performance Max for travel goals.
  • To enable brand guidelines for existing Performance Max campaigns, use a newly added CampaignService.EnablePMaxBrandGuidelines. Disabling brand guidelines is not supported.
  • Added Campaign.brand_guidelines and BrandGuidelines to allow setting the brand's colors and font family.
  • New error values:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Added AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS to support automatically generating enhanced video assets for Performance Max campaigns.

Planning

• (For allowlisted accounts only) Added ContentCreatorInsightsService.GenerateTrendingInsights which allows users to see trending content topics on YouTube for given audience definitions.
• Added GenerateCreatorInsightsRequest.country_locations[] to specify countries to search for the given criteria
• Added GenerateCreatorInsightsRequest.search_brand to specify a brand to search for creators
• Added new fields to YouTubeChannelInsights to provide additional channel information for search_channels requests:
  • channel_url
  • channel_description
  • top_videos
• Added new metadata fields to AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Videos

• Following the release of DataLinkService.CreateDataLink, we added the following methods to allow for mutating previously created data links:
  • RemoveDataLink for removing data links in a Google Ads account
  • UpdateDataLink for accepting, rejecting and revoking data links in a Google Ads account
• Removed support for VIDEO_OUTSTREAM from the following enums:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

v18 (2024-10-16)

The following new features and updates were added in v18.

Account Management

• (For allowlisted accounts only) Added DataLinkService.CreateDataLink, which allows linking a Google Ads account to creator videos hosted on the creator's YouTube channel. Video linking enables the Google Ads account to run partnership ads using creator videos.

Ad Groups

• Added AdGroup.exclude_demographic_expansion which lets you exclude demographics from being expanded when optimized_targeting_enabled is true, a feature that was previously only supported for Demand Gen.

Ads

• Added AdGroupAd.ad_group_ad_asset_automation_settings, which allows opting ads into or out of automatic asset generation.
• Added the following values to AssetAutomationType:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• Added AdNetworkType.GOOGLE_OWNED_CHANNELS, which is used by ads that serve on Google-owned channels such as YouTube, Gmail, and the Discover feed.

Assets

• Renamed AssetType.DISCOVERY_CAROUSEL_CARD to AssetType.DEMAND_GEN_CAROUSEL_CARD.

Campaigns

• Added metrics.store_visits_last_click_model_attributed_conversions, which returns the number of store visits attributed by the last click model of a campaign.
• Added the following video view-related metrics for a campaign:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Added metrics.results_conversions_purchase, which returns conversion purchases for the unified goals results of a campaign.
• Changed the default value of DemandGenCampaignSettings.upgraded_targeting from false to true.

Criterion

• Added content_criterion_view, which returns performance metrics of targeted contents, such as keywords, placements and topics, for Display, Demand Gen and Video campaigns.

Hotel & Travel

• Support for Travel Feeds in Search Ads
  • Added ClickType.TRAVEL_ASSETS to allow segmentation of metrics of Travel Feeds in Search Ads.
  • Added AssetSetType.TRAVEL_FEED which can be used to opt-in and opt-out of using Travel Feed in Search Ads.
• (For allowlisted accounts only) Added travel itinerary as a new conversion value rule with the following new fields and values:
  • ConversionValueRule.itinerary_condition with ValueRuleItineraryCondition, which allows for specifying an advance booking window, an itinerary length, and a travel start days of week
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Added the following segments for campaign and ad_group reports to allow for segmenting performance data based on specific destinations (cities, countries and regions) for Hotel and Search campaigns:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Local Services

• PhoneCallDetails.call_recording_url will be empty, instead of providing an invalid URL if the call recording doesn't exist for the given Local Services lead conversation.
• Added CategoryBid.target_cpa_bid_micro which allows for setting target CPA for a category through Campaign.local_services_campaign_settings.

Performance Max

• Support for brand guidelines
  • Added Campaign.brand_guidelines_enabled, which shows whether brand guidelines are enabled for a given Performance Max campaign. If enabled, assets with field_type set to BUSINESS_NAME, LOGO, LANDSCAPE_LOGO must be linked as CampaignAsset resources instead of AssetGroupAsset resources.
  • Added CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED and CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED errors, which indicate that Performance Max campaigns with brand guidelines enabled don't have the required CampaignAsset resources linked to the campaign.
  • When brand guidelines are enabled, at least one asset with field_type set to BUSINESS_NAME and at least one with LOGO must be linked to the campaign as CampaignAsset resources. Performance Max campaigns for online sales with a product feed must meet this requirement only when there are assets that are linked to the campaign's asset groups.
  • Added the following values to AssetLinkError:
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, which is thrown when attempting to link brand assets to campaigns as CampaignAsset resources instead of AssetGroupAsset resources in Performance Max campaigns with brand guidelines not enabled.
  • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL error, which is thrown when attempting to link brand assets to campaigns as AssetGroupAsset resources instead of CampaignAsset resources in Performance Max campaigns with brand guidelines enabled.
• Added performance_max_placement_view, which returns impressions of the placements where Performance Max ads served.
• Added AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planning

• (For allowlisted accounts only) Added a new service with the method ContentCreatorInsightsService.GenerateCreatorInsights, which allows users to explore insights about top YouTube Creators. This allows customers to search for creators given an audience targeting and content targeting combination or creator insights given a list of YouTube Channel IDs.
• Updates to AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • Moved audience, baseline_audience and data_month into audience_definition.
  • Added audience_description to generate targeting suggestions from a free form text description using generative AI.
• Added AudienceInsightsService.GenerateTargetingSuggestionMetrics, which returns potential reach metrics for given audience targeting combinations.

Recommendations

• RecommendationService.GenerateRecommendations can now be used to generate recommendations about optimized budget suggestions during campaign construction, by including the CAMPAIGN_BUDGET recommendation type in GenerateRecommendationsRequest.recommendation_types[]. This works for Performance Max and Search campaigns.

Reporting

• Replaced the summary_row_setting and return_total_results_count fields of SearchGoogleAdsRequest with the search_settings field, whose type is SearchSettings with the following fields:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Added the following new metrics about general invalid clicks, such as those generated by bots or crawlers, those having irregular patterns. They can be queried with the campaign report.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Added the following values to QuotaError:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Archived release notes

See Sunsetted versions for archived release notes.