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
添加了新的 RPCProvideLeadFeedback
,以提供有关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
以及以下枚举和错误使用信息素材资源的支持。- 枚举:
- 添加了
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
的支持:
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.results_conversions_purchase
,用于返回广告系列统一目标结果的转化购买次数。 - 将
DemandGenCampaignSettings.upgraded_targeting
的默认值从false
更改为true
。
标准
- 添加了
content_criterion_view
,该方法可返回展示广告系列、需求开发广告系列和视频广告系列的定位内容(例如关键字、展示位置和主题)的效果指标。
酒店与旅游
- 支持搜索广告中的旅游 Feed
- 添加了
ClickType.TRAVEL_ASSETS
,以允许细分搜索广告中的旅游 Feed 的指标。 - 添加了
AssetSetType.TRAVEL_FEED
,可用于选择启用和停用搜索广告中的旅游 Feed。
- 添加了
- (仅限已列入许可名单的账号)添加了“旅游行程”作为新的转化价值规则,其中包含以下新字段和值:
- 为
campaign
和ad_group
报告添加了以下细分,以便根据酒店广告系列和搜索广告系列的特定目的地(城市、国家/地区)细分效果数据:
本地生活服务
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
报告查询这些数据。 - 向
QuotaError
添加了以下值:EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
归档版本说明
如需查看归档的版本说明,请参阅已停用的版本。