版本说明

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 添加了 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.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

v18 (2024-10-16)

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

账号管理

• （仅限已列入许可名单的账号）添加了 DataLinkService.CreateDataLink，可将 Google Ads 账号与创作者 YouTube 频道上托管的创作者视频相关联。通过视频关联，Google Ads 账号可以使用创作者视频投放合创广告。

广告组

• 添加了 AdGroup.exclude_demographic_expansion，可让您在 optimized_targeting_enabled 为 true 时排除部分受众特征，此功能之前仅适用于需求开发广告系列。

Ads

• 添加了 AdGroupAd.ad_group_ad_asset_automation_settings，可用于选择启用或停用广告的自动素材资源生成功能。
• 向 AssetAutomationType 添加了以下值：
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• 添加了 AdNetworkType.GOOGLE_OWNED_CHANNELS，供在 YouTube、Gmail 和 Google 探索信息流等 Google 拥有的渠道上投放的广告使用。

素材资源

• 已将 AssetType.DISCOVERY_CAROUSEL_CARD 重命名为 AssetType.DEMAND_GEN_CAROUSEL_CARD。

广告系列

• 添加了 metrics.store_visits_last_click_model_attributed_conversions，该函数可返回通过广告系列的“最终点击”模型归因的实体店光顾次数。
• 为广告系列添加了以下与视频观看相关的指标：
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• 添加了 metrics.results_conversions_purchase，用于返回广告系列统一目标结果的转化购买次数。
• 将 DemandGenCampaignSettings.upgraded_targeting 的默认值从 false 更改为 true。

标准

• 添加了 content_criterion_view，该方法可返回展示广告系列、需求开发广告系列和视频广告系列的定位内容（例如关键字、展示位置和主题）的效果指标。

酒店与旅游

• 支持搜索广告中的旅游 Feed
  • 添加了 ClickType.TRAVEL_ASSETS，以允许细分搜索广告中的旅游 Feed 的指标。
  • 添加了 AssetSetType.TRAVEL_FEED，可用于选择启用和停用搜索广告中的旅游 Feed。
• （仅限已列入许可名单的账号）添加了“旅游行程”作为新的转化价值规则，其中包含以下新字段和值：
  • ConversionValueRule.itinerary_condition，其中包含 ValueRuleItineraryCondition，可用于指定提前预订期限、行程时长和旅行开始时间（周几）
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• 为 campaign 和 ad_group 报告添加了以下细分，以便根据酒店广告系列和搜索广告系列的特定目的地（城市、国家/地区）细分效果数据：
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

本地生活服务

• PhoneCallDetails.call_recording_url 将为空，而不是在给定的本地服务潜在客户对话不存在通话录音时提供无效的网址。
• 添加了 CategoryBid.target_cpa_bid_micro，可通过 Campaign.local_services_campaign_settings 为类别设置目标每次转化费用。

效果最大化广告系列

• 支持品牌推广指南
  • 添加了 Campaign.brand_guidelines_enabled，用于显示指定效果最大化广告系列是否启用了品牌推广指南。如果启用，则必须将 field_type 设置为 BUSINESS_NAME、LOGO、LANDSCAPE_LOGO 的资源作为 CampaignAsset 资源（而非 AssetGroupAsset 资源）进行关联。
  • 添加了 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED 和 CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED 错误，这些错误表示启用了品牌推广指南的效果最大化广告系列未关联到所需的 CampaignAsset 资源。
  • 启用品牌推广指南后，必须将至少一个 field_type 设置为 BUSINESS_NAME 的素材资源和至少一个 LOGO 的素材资源作为 CampaignAsset 资源与广告系列相关联。以提高线上销售额为目标且使用产品 Feed 的效果最大化广告系列只有在有素材资源与广告系列的素材资源组相关联时，才必须满足此要求。
  • 向 AssetLinkError 添加了以下值：
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL，当尝试将品牌素材资源与广告系列关联为 CampaignAsset 资源（而不是AssetGroupAsset 资源）时，如果效果最大化广告系列未启用品牌推广指南，则会抛出此异常。
  • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL错误，当尝试将品牌素材资源作为 AssetGroupAsset 资源（而非 CampaignAsset 资源）关联到启用了品牌推广指南的效果最大化广告系列时，系统会抛出此错误。
• 添加了 performance_max_placement_view，用于返回效果最大化广告投放的展示位置的展示次数。
• 添加了 AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

规划

• （仅限已列入许可名单的账号）新增了一项服务，该服务通过 ContentCreatorInsightsService.GenerateCreatorInsights 方法实现，可让用户探索有关热门 YouTube 创作者的数据洞见。这样一来，客户就可以根据受众群体定位和内容定位组合来搜索创作者，或者根据 YouTube 频道 ID 列表来搜索创作者数据分析。
• 对 AudienceInsightsService.GenerateSuggestedTargetingInsights 进行了更新：
  • 将 audience、baseline_audience 和 data_month 移至 audience_definition。
  • 添加了 audience_description，用于使用生成式 AI 根据自由格式的文本说明生成定位建议。
• 添加了 AudienceInsightsService.GenerateTargetingSuggestionMetrics，该方法可针对给定的受众群体定位组合返回潜在覆盖面指标。

建议

• RecommendationService.GenerateRecommendations现在可用于在广告系列制作期间生成有关优化预算的建议，方法是在 GenerateRecommendationsRequest.recommendation_types[] 中添加 CAMPAIGN_BUDGET 建议类型。 此功能适用于效果最大化广告系列和搜索广告系列。

报告

• 将 SearchGoogleAdsRequest 的 summary_row_setting 和 return_total_results_count 字段替换为 search_settings 字段，该字段的类型为 SearchSettings，包含以下字段：
  • omit_results
  • return_summary_row
  • return_total_results_count
• 添加了以下有关常规无效点击的新指标，例如由漫游器或抓取工具生成的无效点击、具有不规则模式的无效点击。您可以使用 campaign 报告查询这些数据。
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• 向 QuotaError 添加了以下值：
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

归档版本说明

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