版本说明

v22（2025 年 10 月 15 日）

v22 中添加了以下新功能和更新。

如需相关指导，请参阅升级到最新版本。

素材资源

• 添加了 LANDING_PAGE_PREVIEW 作为新的图片素材资源字段类型。
• 推出了 AssetGenerationService（Beta 版）：
  • 此服务允许使用生成式 AI 生成文字和图片素材资源。此服务最初仅面向有限的一组封闭式 Beta 版参与者提供。
  • GenerateText：根据最终到达网址、自由格式提示、关键字和现有广告系列背景信息等输入内容生成文字。
  • GenerateImages：根据最终到达网址、自由格式提示、现有广告系列背景信息等输入内容生成图片，或通过重新确定现有商品图片的背景信息来生成图片。
  • 素材资源生成期间的错误会以 AssetGenerationErrorEnum 中的代码返回。

广告系列

• 为应用安装广告系列 (ACi) 添加了新的出价目标，可在不指定目标的情况下进行优化，有助于快速扩大规模或在难以确定合适的目标时使用。在 AppCampaignBiddingStrategyGoalType 中：
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA：与标准尽可能提高转化次数出价策略搭配使用。
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS：与标准尽可能提高转化价值出价策略搭配使用。
• 新增了对固定展示份额出价策略类型的支持。
• 添加了 Campaign.feed_types，用于显示附加到广告系列的 Feed 类型。对于效果最大化广告系列，此值可以表示业务垂直行业，例如零售行业的 MERCHANT_CENTER_FEED。
• 允许将 NEGATIVE_KEYWORDS 共享集附加到 MULTI_CHANNEL（对于应用广告系列）和 LOCAL 广告系列。

需求开发

• 为需求开发广告系列添加了“目标每次点击费用”出价策略。此策略会设置出价，以在配置的目标每次点击费用 (CPC) 下尽可能争取更多点击次数。
  • 使用 Campaign.target_cpc 设置广告系列级目标每次点击费用。
  • 使用 AdGroup.target_cpc_micros 在广告组级别进行替换。
• 添加了新的 AssetAutomationType：
  • GENERATE_DESIGN_VERSIONS_FOR_IMAGES：适用于 DemandGenMultiAssetAds。如果启用此功能，系统会将设计元素添加到图片素材资源中，并将文字素材资源嵌入到图片素材资源中，以创建具有不同宽高比的新图片素材资源。默认情况下，新 DemandGenMultiAssetAds 处于启用状态。
• 添加了新的 AssetAutomationType：
  • GENERATE_VIDEOS_FROM_OTHER_ASSETS：适用于 DemandGenMultiAssetAds。 如果启用此功能，系统会使用图片和文字等其他素材资源生成视频。 然后，您可以使用这些视频来制作新的DemandGenVideoResponsiveAds。 默认情况下，新 DemandGenMultiAssetAds 处于启用状态。
• 将字段 BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros 重命名为 minimum_budget_amount_micros。

常规

• 添加了每 AddBatchJobOperations 请求 10,000 次操作的限制。
• 更新了 ListBatchJobResultsRequest 中 page_size 字段的处理方式：
  • 如果未设置 page_size 或将其设置为 0，则现在默认设置为最大值 1,000（之前返回 INVALID_PAGE_SIZE）。
  • 如果 page_size 超过 1,000，API 现在会返回 INVALID_PAGE_SIZE 错误（之前会默默地将上限设为 1,000）。
• 添加了新的错误代码： QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED 用于指示何时超出付款资料激活率限制。

效果最大化广告系列

• 为效果最大化广告系列添加了新的AssetAutomationType值：
  • GENERATE_IMAGE_ENHANCEMENT： 启用自动创建增强型图片的功能，例如自动剪裁。 默认处于启用状态。
  • GENERATE_IMAGE_EXTRACTION： 启用自动从最终到达网址中获取图片的功能。默认采用账号级动态图片附加信息设置。
• 移除了效果最大化广告系列的 AssetPerformanceLabel。
• 已移除的 Campaign.url_expansion_opt_out 的功能现在通过在 AssetAutomationSetting 中设置 AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 来管理。
• 为效果最大化广告系列添加了新的细分。这些细分数据仅适用于效果最大化广告系列，如果选择任何其他广告系列类型，系统都不会返回数据。
  • ad_using_product_data：表示广告是否使用 Google Merchant Center Feed 中的商品数据。
  • ad_using_video：表示广告是否使用视频素材资源。

规划

• 在 UserListCrmDataSourceType 中，添加了值 THIRD_PARTY_PARTNER_DATA。
• 添加了与合作伙伴受众群体相关的新错误代码：
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• 已将 is_active_live_stream_creator 添加到 YouTubeMetrics。由 ContentCreatorInsightsService.GenerateCreatorInsights 返回，用于指示创作者是否在过去 90 天内发布过直播。

• 在 PlannableUserList 中添加了包含 UserListCrmDataSourceType 的新 PlannableUserListMetadata 消息。此消息由 ReachPlanService.ListPlannableUserLists 返回，用于显示 CRM 用户名单数据源是 FIRST_PARTY 还是 THIRD_PARTY_PARTNER_DATA。

• 在 ReachPlanService 中，添加了字段 trueview_views，该字段取代了 views 字段。

• 在 TrendInsight 中，添加了对 related_videos 和 related_creators 的支持。还在 YouTubeVideoAttributeMetadata.video_properties 和 YouTubeVideoAttributeMetadata.publish_date 中添加了视频属性元数据和发布日期。

• AudienceInsightsService.GenerateInsightsFinderReport 现在支持 parental_status 和 income_ranges，以及更复杂的 AND/OR 主题和受众群体组合。

报告

• 添加了两种新的点击类型：CLICK_TO_MESSAGE_THIRD_PARTY_CLICK 和 CLICK_TO_MESSAGE_LANDING_PAGE_CLICK。
• AssetGroupAsset 现在可按 device、conversion_action、conversion_action_name 和 conversion_action_category 进行细分。
• AdGroupAdAssetView 和 AdGroupAdAssetCombinationView 现在完全支持 RESPONSIVE_SEARCH_AD 的效果和转化指标。 以前，在这些视图中，系统仅针对此类广告返回展示次数。
• 为了方便您探索智能出价，以下指标现在可按日期字段（date、month、quarter、week、year）进行细分：
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• 添加了一个新资源：TargetingExpansionView，用于报告与人工定位相比，扩展带来的效果指标，例如 AI Max 搜索广告系列的无关键字扩展。

• 为效果最大化广告系列添加了新的细分。请参阅效果最大化广告系列更新。

  购物

• 修复了 ShoppingProduct 资源中指标的广告系列和广告组范围。

统一目标

• 添加了对“客户留存”目标的支持，以便以重新吸引现有客户为目标进行优化。
  • 使用 CampaignRetentionGoalSettings.target_option 配置定位：
    • TARGET_SPECIFIC： 仅使用与广告系列关联的用户名单中的用户。（目前仅限许可名单上的用户使用）。
    • TARGET_ALL （默认）：定位所有用户以进行再互动。

视频

• 重命名了多个与视频观看次数相关的指标：
  • average_cpv现已更名为 trueview_average_cpv
  • video_view_rate现已更名为 video_trueview_view_rate
  • video_views现已更名为 video_trueview_views
  • video_view_rate_in_feed现已更名为 video_trueview_view_rate_in_feed
  • video_view_rate_in_stream现已更名为 video_trueview_view_rate_in_stream
  • video_view_rate_shorts现已更名为 video_trueview_view_rate_shorts
• 添加了视频广告观看时长的指标：
  • video_watch_time_duration_millis：总观看时长。
  • average_video_watch_time_duration_millis：每次展示的平均观看时长。

v21 (2025-08-06)

如需相关指导，请参阅升级到最新版本。

AI Max 搜索广告系列

• 您现在可以使用 Campaign 的 ai_max_setting.enable_ai_max 字段来启用 AI Max 搜索广告系列。AI Max 搜索广告系列通过搜索字词匹配扩大搜索广告系列的覆盖面，并允许控制定位和广告素材控制功能在设置后是否生效。在之前的版本请求中设置的文字素材资源自动化和品牌列表控制功能仍会生效，直到明确切换并停用搜索广告系列的 AI Max 为止。 Campaign.ai_max_setting.bundling_required 可用于确定是否必须启用搜索广告系列的 AI Max 才能生效或修改文字素材资源自动化和品牌列表控制功能。 AdGroup.ai_max_ad_group_setting.disable_search_term_matching 可用于在父广告系列已为搜索广告系列启用 AI Max 时停用搜索字词匹配。请参阅我们的博文利用 AI Max 搜索广告系列，助力广告效果再创新高。

• 添加了 CampaignError.AI_MAX_MUST_BE_ENABLED，当您选择启用 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 但未在广告系列中启用 AI Max 搜索广告系列时，系统会针对搜索广告系列抛出此异常。

• 新增了对在 AI Max 搜索广告系列中应用广告组级定位控制的支持。您现在可以向广告组添加以下条件：

  • 品牌列表
  • 位置
  • 网页（网址规则）

• 添加了 ai_max_search_term_ad_combination_view，用于报告搜索字词、标题和着陆页组合的效果。此视图显示了哪些搜索查询触发了您的广告，以及这些特定组合的成效如何。在未来的版本中，我们将添加一个也包含效果最大化广告系列数据的视图。如果您想避免迁移实现来获取效果最大化广告系列数据，请考虑等待该版本发布。

• 为 search_term_match_type 段添加了新值 AI_MAX。

素材资源

• 在 PromotionAsset 中添加了字段 terms_and_conditions_text、terms_and_conditions_uri、promotion_barcode_info 和 promotion_qr_code_info。条形码和二维码字段位于 promotion_trigger oneof 中。请参阅帮助中心文章促销信息素材资源简介。

• 将 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 添加到 AssetAutomationTypeEnum。借助此设置，您可以控制搜索广告系列中文字素材资源和着陆页从最终到达网址自动生成的方式。

• 添加了一项新服务 AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset，用于从 Campaign 中移除自动制作的素材资源。此服务仅支持移除最终到达网址扩展素材资源。

• 向 ServedAssetFieldType 枚举添加了 DESCRIPTION_PREFIX。此问题已修正：ad_group_ad_asset_combination_view 中的 served_asset_field_type 对于用作说明前缀的资源为 UNKNOWN。

广告系列

• 向 CampaignPrimaryStatusReason 添加了新的枚举值 MISSING_LOCATION_TARGETING。 此新状态原因仅会针对未指定地理位置定位的受地理位置限制的广告系列返回。对于受地理位置限制的广告系列，任何尝试在允许的区域之外添加地理位置定位条件的行为都会导致条件错误 LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN。

• 在 VideoCustomer.third_party_integration_partners 和 Campaign.third_party_integration_partners 级别添加了对第三方集成合作伙伴的支持。请参阅帮助中心文章使用第三方应用分析工具跟踪应用转化情况。

• 您现在可以为现有 Campaign 设置 advertising_partner_ids 字段。以前，此字段只能在制作新广告系列时设置。设置后，该字段仍不可变。

• 通过使用在经理账号一级定义的 TYPE_PLACEMENT_LIST 类型的共享列表，广告客户现在可以使用 CustomerNegativeCriterion 条件来排除各个广告客户账号中的一系列展示位置。

• 向 ServedAssetFieldType 枚举添加了 DESCRIPTION_PREFIX。此问题已得到修正，即 ad_group_ad_asset_combination_view 中的 served_asset_field_type 对于用作说明前缀的资源为 UNKNOWN。

• 在 MaximizeConversionValue 和 TargetRoas 出价策略中添加了对 target_roas_tolerance_percent_millis 字段的支持。TargetRoas.target_roas_tolerance_percent_millis 仅适用于组合出价策略，而组合出价策略仅适用于搜索广告系列。

• 更改了 ProductGroup 错误代码。对于启用部分失败的请求，系统将返回 LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION，而不是 INVALID_LISTING_GROUP_HIERARCHY。

• 新增了资源 LocationInterestView，用于汇总广告组地理位置兴趣标准的效果。

转化次数

• 为 conversion_attribution_event_type 段添加了新值 ENGAGED_VIEW。

• 客户将无法再在 ConversionUploadService 中使用 debug_enabled 模式。如果此字段设置为 TRUE，则之前用于区分增强型潜在客户转化数据导入的 CLICK_NOT_FOUND 错误与 SUCCESS 错误。

需求开发

• 添加了错误代码 CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM。 未来，如果尝试为需求开发广告系列设置非常低的预算金额，系统将返回此错误。您可以在新的错误详情字段 budgetDailyMinimumErrorDetails 中找到有关所需最低预算的详细信息。

欧盟政治广告变更

v19.2 和 v20.1 版本中也做出了这些欧盟政治广告变更。

• 添加了 Campaign.contains_eu_political_advertising。 此字段用于指明您的广告系列是否包含面向欧盟的政治广告内容。如果此字段设置为 CONTAINS_EU_POLITICAL_ADVERTISING，则自 2025 年 9 月 22 日起，相应广告系列将无法在欧盟境内投放。如果未设置此字段，则用于创建新广告系列的 API 调用将失败，并显示 FieldError.REQUIRED 错误。

  对于任何现有广告系列，您都应先设置 contains_eu_political_advertising 字段，然后再尝试在广告系列或广告组一级更改邻近区域、地理位置或地理位置组定位。如果广告系列尚未完成自我声明，则用于为现有广告系列创建或更新这些广告系列或广告组定位条件的 API 调用将失败，并显示 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。

  对于版本 v19.x 和 20.x，目前尚未强制要求设置此字段，但未来会强制要求。此项变更将提前公布。

• 如果实验的广告系列未自行声明是否包含定位到欧盟的政治广告，则试用和实验会抛出 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

效果最大化广告系列

• 对于新的效果最大化广告系列，Campaign.brand_guidelines_enabled 的默认值现在为 true。

• 添加了 campaign_search_term_view 报告。此视图显示了广告系列级别的汇总搜索字词指标。此视图还引入了对搜索字词的效果最大化广告系列支持。

• 为 search_term_match_type 段添加了新值 PERFORMANCE_MAX。

规划

• 添加了一种新方法 ReachPlanService.ListPlannableUserInterests，可让广告客户发现 ReachPlanService.GenerateReachForecast 支持的用户兴趣（相似细分和有购买意向的细分）。该方法支持搜索特定用户兴趣类型，以及查询名称和路径。

• 向 ReachPlanService.ListPlannableUserLists 添加了 AdditionalApplicationInfo 作为可选输入字段。

• 添加了对 AudienceInsightsService.ListAudienceInsightsAttributes 的支持，以获取发出请求的客户 ID 的可用第一方用户名单。

• 向 AudienceInsightsService.GenerateAudienceCompositionInsights 添加了第一方用户名单支持，以获取定位到用户名单的受众群体的分析洞见。以用户列表为目标的任何请求都只会返回受众群体指数，并且仅适用于以下 AudienceInsightsDimension：AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST。

• 已将受众群体输入类型更新为 AudienceInsightsService.GenerateTargetingSuggestionMetrics 的 InsightsAudience。 新的受众群体输入功能支持用户兴趣的“或”与“与”组合，从而为更自定义的受众群体定义提供潜在覆盖面指标。

• 向 TrendInsightMetrics 添加了受众群体份额，以获取趋势的受众群体份额。

• 向 KnowledgeGraphAttributeMetadata 添加了新的相关类别，以便用户按类别过滤知识图谱属性。

报告

• 现在，AssetGroupAsset、ChannelAggregateAssetView 和 CampaignAggregateAssetView 中提供各种新指标。此外，对于 ChannelAggregateAssetView 和 CampaignAggregateAssetView，之前在效果最大化广告系列中归零的 impressions 现在将报告其真实值。

• 使 AssetSet 资源可通过 ChangeStatus 进行选择，以便用户在一个查询中获取有关 AssetSet 或 CampaignAssetSet 类型资源的更多信息。

• 使 CampaignAssetSet 资源可通过 ChangeStatus 进行选择，以便用户在一次查询中获取有关 AssetSet 或 CampaignAssetSet 类型资源的更多信息。

• 添加了可在广告系列搜索字词视图中选择的新细分 search_term_targeting_status。

• 添加了新的 final_url_expansion_asset_view。

• 在 AssetGroup 报告中添加了对指标 value_adjustment 和 all_value_adjustment 的支持。

• 使 AssetGroupAsset 可按 ad_network_type 进行细分。

• 添加了一个可与 landing_page_view 资源搭配使用的新细分 landing_page_source。

• 添加了一个新的细分 search_term_match_source，可在搜索字词视图和广告系列搜索字词视图中选择。

• 添加了一个新的细分match_type，可从关键字视图中选择。

• 新增了对以下指标的支持，用于衡量唯一搜索查询意图聚类：

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• 在 click_view 细分中添加了新的点击类型 VEHICLE_ASSETS，用于跟踪和报告与车辆素材资源特有的广告格式相关的点击。

针对搜索广告中的“目标广告支出回报率”出价策略的智能出价探索

• 现在，您可以通过以下方式在搜索广告系列中启用智能出价探索：将 MaximizeConversionValue 和 TargetRoas 出价策略中的 target_roas_tolerance_percent_millis 字段设置为介于 10000（10%）到 30000（30%）（含）之间的任何可被 1000 整除的值。MaximizeConversionValue 出价策略还需要设置 target_roas 字段。TargetRoas.target_roas_tolerance_percent_millis 仅适用于组合出价策略。请参阅我们关于智能出价探索的博文和帮助中心文章。

• 现在，对于唯一查询意图聚类，系统支持以下指标的汇总多样性报告。Google Ads 界面中提供了按时间段细分的视图。

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

视频

• 添加了 YouTubeVideoListAsset。 还添加了 Asset#youtube_video_list_asset，可用于在 campaign 和 YouTubeVideoListAsset 类型之间创建链接。请参阅帮助中心文章使用相关视频。

• 向 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 添加了新的元数据字段。

• 公开了新的点击类型：VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK 和 PRODUCT_ASSETS。

• 向 VideoAdInventoryControl 添加了 allow_non_skippable_in_stream 字段，以允许自适应视频广告以不可跳过的插播广告的形式投放。此选项适用于支持将不可跳过的广告格式与其他广告格式混用的广告系列。

• 添加了 Campaign.VideoCampaignSettings.video_ad_sequence 和 AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting 字段（只读）。请参阅帮助中心文章依序展示的视频广告简介。

• 向 YouTubeChannelInsights 和 YouTubeVideoAttributeMetadata 添加了新的元数据字段。

• 向 CampaignCriterion 和 AdGroupCriterion 添加了 VIDEO_LINEUP 条件类型和 video_lineup 字段。此功能仅适用于许可名单上的账号。如需了解详情，请与您的 Google 业务开发代表联系。

• 添加了详细信息级和分组级内容适宜性报告。请参阅帮助中心文章“内容适宜性”报告简介。

v20.1 (2025-08-06)

v19.2 和 v21 版本中也做出了这些欧盟政治广告变更。

欧盟政治广告变更

• 添加了 Campaign.contains_eu_political_advertising。 此字段用于指明您的广告系列是否包含面向欧盟的政治广告内容。如果此字段设置为 CONTAINS_EU_POLITICAL_ADVERTISING，则自 2025 年 9 月 22 日起，相应广告系列将无法在欧盟境内投放。

  对于任何现有广告系列，您都应先设置 contains_eu_political_advertising 字段，然后再尝试在广告系列或广告组一级更改邻近区域、地理位置或地理位置组定位。如果广告系列尚未完成自我声明，则用于为现有广告系列创建或更新这些广告系列或广告组定位条件的 API 调用将失败，并显示 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。

  对于版本 v19.x 和 20.x，目前尚未强制要求设置此字段，但未来会强制要求。此项变更将提前公布。

• 如果实验的广告系列未自行声明是否包含面向欧盟的政治广告，则试验和实验会抛出 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

v20（2025 年 6 月 4 日）

v20 中添加了以下新功能和更新。

如需相关指导，请参阅升级到最新版本。

素材资源

为 asset_group 报告添加了多个新的指标和细分列。

指标列

• 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

细分列

• 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

广告系列

• 为效果最大化广告系列添加了对添加和更新广告系列级否定关键字的支持。

转化次数

• 您现在可以更新现有客户的 google_ads_conversion_customer 字段，以选择采用跨账号转化跟踪，或将其现有的转化跟踪父级更改为其他经理账号。

  注意： 此功能仅适用于许可名单中的用户。如需使用此功能，请与您的客户经理联系。

• 添加了 ClickConversion.user_ip_address 字段。Google Ads 不支持针对欧洲经济区 (EEA)、英国 (UK) 或瑞士 (CH) 境内的最终用户进行 IP 地址匹配。请添加逻辑，以有条件地排除来自这些地区的用户分享 IP 地址。请务必清楚、全面地向用户提供与您在网站、应用和其他媒体资源上收集的数据有关的信息，并根据法律或任何适用的 Google 政策征得用户同意。如需了解详情，请参阅线下转化数据导入简介页面。

需求开发

• 为 ad_network_type 段添加了新值，以便按渠道细分需求开发广告系列：
  • MAPS
  • GMAIL
  • DISCOVER
• 添加了可与其他平台对比的转化指标：
  • 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

建议

• 在使用 GenerateRecommendationsRequest 时，添加了对在广告系列制作过程中使用 ShoppingSetting 的支持。
• 向 GenerateRecommendationsRequest 添加了 merchant_center_account_id 字段，以指明何时应为零售专用效果最大化广告系列（而非标准效果最大化广告系列）生成建议。

规划

• 添加了 AudienceInsightsDimension.YOUTUBE_LINEUP，以取代 AudienceInsightsService 和 ContentCreatorInsightsService 中的 AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP。借助此新维度，您可以检索 YouTube 优选频道组 (YTS) 的数据分析和元数据。替换了与 YOUTUBE_DYNAMIC_LINEUP 关联的对象（例如 DynamicLineupAttributeMetadata 和 AudienceInsightsDynamicLineup），以配合 Google Ads 中更广泛的动态阵容移除工作。 此功能仅适用于许可名单中的账号。
• 在 AudienceInsightsService、ContentCreatorInsightsService 和 ReachPlanService 中添加了 AdditionalApplicationInfo 和 ApplicationInstance。此功能仅适用于已列入许可名单的账号。
• 更新了 AudienceInsightsService 和 ContentCreatorInsightsService，以提供更详细的数据分析。现在，您可以在这两个服务中使用新的 AudienceInsightsDimension.DEVICE 和 AudienceInsightsAttribute.device 按设备细分内容创作者数据。此功能仅适用于已加入许可名单的账号。
• 向 GenerateCreatorInsightsResponse 添加了更多汇总视频指标，以便更全面地分析创作者内容：engagement_rate、average_views_per_video、average_likes_per_video、average_shares_per_video、average_comments_per_video、shorts_views_count、shorts_video_count 和 is_brand_connect_creator。 此功能仅适用于许可名单中的账号。
• 为 ContentCreatorInsightsService 向 GenerateCreatorInsightsRequest 添加了 sub_country_locations。这样就可以指定国家/地区级地理位置，以优化创作者数据分析的搜索。仅当在 criteria 字段中使用 search_attributes oneof 时，才支持 sub_country_locations 字段。如果 sub_country_locations 与其他条件类型一起提供，则请求将无效。这样一来，创作者数据分析就能实现更精细的地理位置定位和分析。 此功能仅适用于许可名单中的账号。
• 添加了 ReachPlanService.ListPlannableUserLists，用于返回客户拥有的第一方用户名单；并在 GenerateReachForecastRequest 中向受众群体定位选项添加了 UserListInfo。 这样一来，您就可以检索指定客户的可规划用户名单，然后针对定位到这些特定受众群体的广告系列生成覆盖面预测。这些增强功能可将第一方受众群体数据直接纳入预测，从而改进量身定制的覆盖面规划。 覆盖面预测功能仅适用于已列入许可名单的账号。

视频

• 添加了在电视屏幕上的 YouTube 非广告视频中投放的 AdFormatType.PAUSE 广告，这些广告会纳入报告中。这些广告直接显示在暂停屏幕上静态视频帧的旁边。这不包括在暂停的自然视频下方或上方的广告面板中展示的需求开发视频广告，此类广告会归入 AdFormatType.INFEED 下进行报告。

v19.2（2025-08-06）

v20.1 和 v21 版本中也做出了这些欧盟政治广告变更。

欧盟政治广告变更

• 添加了 Campaign.contains_eu_political_advertising。 此字段用于指明您的广告系列是否包含面向欧盟的政治广告内容。如果此字段设置为 CONTAINS_EU_POLITICAL_ADVERTISING，则自 2025 年 9 月 22 日起，相应广告系列将无法在欧盟境内投放。

  对于任何现有广告系列，您都应先设置 contains_eu_political_advertising 字段，然后再尝试在广告系列或广告组一级更改邻近区域、地理位置或地理位置组定位。如果广告系列尚未完成自我声明，则用于为现有广告系列创建或更新这些广告系列或广告组定位条件的 API 调用将失败，并显示 CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION 错误。

  对于版本 v19.x 和 20.x，目前尚未强制要求设置此字段，但未来会强制要求。等待有关此变更的公告。

• 如果实验的广告系列未自行声明是否包含面向欧盟的政治广告，则试验和实验会抛出 ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION。

v19.1（2025-04-16）

v19.1 中新增了以下功能和更改。

素材资源

• 为 AssetGroup 添加了 asset_coverage 字段，该字段会返回有关素材资源组中存在哪些缺口的信息。
  • 包含一个子字段 ad_strength_action_items，该子字段会返回广告客户可采取的措施列表，以提高素材资源组的广告效力。

广告系列

• 现在，您可以为本地生活服务广告系列中的潜在客户评分或提供反馈。在此次更改中，v19.1
  • 添加了名为 LocalServicesLeadService 的新服务。您可以使用 ProvideLeadFeedback 方法上传潜在客户的评分和反馈。
  • 向 LocalServicesLead 添加了一个名为 lead_feedback_submitted 的新字段，以帮助确定是否已向潜在客户提交反馈。
• 为应用广告系列添加了新的指标列 biddable_cohort_app_post_install_conversions。

需求开发

• 在规划服务中引入了其他方法，以支持需求开发广告系列。

• 新增了对广告组级需求开发广告系列渠道控制选项的支持。 您可以使用 demand_gen_ad_group_settings 字段选择预定义的常规渠道分组，也可以选择部分渠道。当前版本支持以下渠道：

  • YouTube 插播广告
  • YouTube 信息流
  • YouTube Shorts
  • Google 探索
  • Gmail
  • 显示

• 为 TALL_PORTRAIT_MARKETING_IMAGE 公开了一种新的素材资源类型。 此素材资源类型与需求开发多素材资源广告格式的 tall_portrait_marketing_images 字段相关。

更改历史记录

• 在 ChangeStatusResourceType 中添加了对另外三种资源类型的支持：
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• 您可以从 change_status 报告中检索这三种更精细的类型。

转化次数

• 现在，您可以使用 Google Ads API 在创建新客户时设置 google_ads_conversion_customer 字段。此字段之前是只读字段。

  注意：此功能仅适用于许可清单中的项目。如需使用此功能，请与您的客户经理联系。

  注意： 此功能仅适用于许可名单中的用户。如需使用此功能，请与您的客户经理联系。

• 现在，您可以在上传线下转化数据时指定与转化关联的客户类型。

• 为 ClickConversion 引入了新的 session_attributes 字段。

本地生活服务广告

• 向 LocalServicesLeadService 添加了新的 RPC ProvideLeadFeedback，以提供有关 LocalServicesLead 质量的反馈。
• 向 LocalServicesLead 资源添加了一个新字段 lead_feedback_submitted，用于确认是否已针对特定资源提供反馈。

规划服务

• 在 ReachPlanService.GenerateReachForecast 中添加了对“目标频次”月度预测的支持。
  • 开发者在使用 TARGET_FREQUENCY 可规划的商品代码生成“目标频次”每月覆盖面预测时，可以在 TargetFrequencySettings 中设置 TargetFrequencyTimeUnit.MONTHLY。
• 添加了一个新方法 ReachPlanService.GenerateConversionRates，可让广告客户请求受支持的可规划产品的建议转化率。
• ReachPlanService.GenerateReachForecast 中的需求开发广告系列预测：
  • 开发者现在可以为需求开发广告系列请求覆盖面预测。 开发者可以使用新的 DEMAND_GEN_MAX_CONVERSIONS 可规划产品代码来生成需求开发广告系列的覆盖面预测。
  • 新增了 conversion_rate 字段，以便请求需求开发广告系列覆盖面预测的开发者提供转化率。您可以使用新的 ReachPlanService.GenerateConversionRates 方法检索建议的转化率。此字段是需求开发预测请求的必需字段。其他可规划的产品不支持此功能。
  • 向返回的预报添加了新的 conversions 字段。此字段包含覆盖面曲线中给定点的转化次数。转化仅支持 DEMAND_GEN_MAX_CONVERSIONS 可规划的商品。

建议

• 新的 ad_strength 字段适用于 ImprovePerformanceMaxAdStrengthRecommendation，该字段会返回与建议关联的素材资源组的当前广告效力得分。

  购物

• 您现在可以替换效果最大化广告系列中购物广告的品牌排除对象。此功能通过广告系列级的新 pmax_campaign_settings 字段公开，并且仅适用于零售效果最大化广告系列。 如果您尝试为不兼容的广告系列类型设置此字段，系统会抛出新的 CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED 错误。

视频

• 为音频广告添加了只读支持。如需了解此功能，请参阅 Google Ads 帮助中心。此变更公开了以下内容：
  • 名为 YOUTUBE_AUDIO 的新 AdvertisingChannelSubType。
  • 名为 YOUTUBE_AUDIO 的新 AdGroupType。
  • 一种名为 YOUTUBE_AUDIO_AD 的新广告格式枚举，以及其对应的 YouTubeAudioAdInfo 字段。
• 向查询覆盖面指标添加了新的指标和细分（包含人口统计调整）。这些变化包括：
  • 我们推出了两个新的指标列，分别名为 coviewed_impressions 和 primary_impressions。
  • 我们推出了两个名为 adjusted_age_range 和 adjusted_gender 的新细分。
  • 如果选择这两个新细分中的任一个，同时选择覆盖面指标字段（coviewed_impressions、primary_impressions、unique_users 或 average_impression_frequency_per_user），则还必须选择另一个细分，才能检索这些列的有效统计信息。
  • 此功能目前仅适用于许可名单上的客户。

v19 (2025-02-26)

v19 中添加了以下功能和更改。

如需相关指导，请参阅升级到最新版本。

账号管理

• 为 CustomerError 添加了以下值，以应对即将到来的变化：
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Ads

• 添加了 DemandGenMultiAssetAdInfo.tall_portrait_marketing_images，以支持需求开发广告中宽高比为 9:16 的纵向图片素材资源。

素材资源

• （仅限已列入许可名单的账号）通过 Asset.business_message_asset、BusinessMessageAsset 以及以下枚举和错误添加了对私信素材资源的支持。
  • 枚举：
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • 错误：
    • 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
• 添加了 AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW，以支持自动生成着陆页预览。
• 现在，AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS 默认处于启用状态，适用于视频需求开发自适应广告。
• （仅适用于已列入许可名单的账号；许可名单目前已关闭）添加了 Asset.app_deep_link_asset 和 AppDeepLinkAsset。

转化次数

• 转化目标
  • LifecycleGoalValueSettings.high_lifetime_value 已结束 Beta 版测试，现在可变。
  • 添加了 CustomerLifecycleGoal.owner_customer，用于显示拥有客户生命周期目标的客户的资源名称。
• 废弃了 ConversionActionType.SALESFORCE。

Feed

• 移除了所有与 Feed 相关的实体，例如 Feed、FeedMapping、FeedService、AdGroupFeed、feed_placeholder_view 等。用户现在应使用 assets 来实现相同的目的。

酒店与旅游

• 将 ValueRuleItineraryAdvanceBookingWindow 的 min_days 和 max_days 设为 optional 字段，以允许指定 0 作为值。这支持定位到今天发生的旅行搜索。

效果最大化广告系列

• （仅限已列入许可名单的账号）品牌推广指南
  • 仅在制作效果最大化广告系列时可变。Campaign.brand_guidelines_enabled
  • 此目标与指定旅行目标的效果最大化广告系列不兼容。
  • 如需为现有的效果最大化广告系列启用品牌推广指南，请使用新添加的 CampaignService.EnablePMaxBrandGuidelines。 不支持停用品牌推广指南。
  • 添加了 Campaign.brand_guidelines 和 BrandGuidelines，以允许设置品牌的颜色和字体系列。
  • 新错误值：
    • 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
• 添加了 AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS，以支持为效果最大化广告系列自动生成增强型视频素材资源。

规划

• （仅限已列入许可名单的账号）添加了 ContentCreatorInsightsService.GenerateTrendingInsights，可让用户查看 YouTube 上针对指定受众群体定义的热门内容主题。
• 添加了 GenerateCreatorInsightsRequest.country_locations[] 以指定要搜索给定条件的国家/地区
• 添加了 GenerateCreatorInsightsRequest.search_brand 以指定要搜索的创作者品牌
• 为 YouTubeChannelInsights 添加了新字段，以便为 search_channels 请求提供更多渠道信息：
  • channel_url
  • channel_description
  • top_videos
• 向 AudienceInsightsAttributeMetadata 添加了新的元数据字段：
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

视频

• 在发布 DataLinkService.CreateDataLink 之后，我们添加了以下方法，以允许更改之前创建的数据关联：
  • RemoveDataLink，用于移除 Google Ads 账号中的数据关联
  • UpdateDataLink，用于在 Google Ads 账号中接受、拒绝和撤消数据关联
• 从以下枚举中移除了对 VIDEO_OUTSTREAM 的支持：
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

归档版本说明

如需查看归档的版本说明，请参阅已停用的版本。