
Google 正式发布 Google Ads API v23 版本。作为 2026 年的首个重大更新,该版本显著提升了发布节奏,新增了 Performance Max 广告网络类型细分报告、激励措施编程化支持及多项转化控制功能,旨在为开发者提供更精细的数据洞察与自动化管理能力。
核心功能更新概览
Performance Max 报告与数据细分增强
- 广告网络类型细分:正式为 Performance Max 活动启用广告网络类型(ad_network_type)细分,支持更精准的表现分析。
- 子网络类型细分:新增 ad_sub_network_type 指标,适用于 YouTube Demand Gen 活动(In-stream、In-feed、Shorts),需与广告网络类型一同使用。
- 响应式展示广告指标:AdGroupAdAssetView 和 AdGroupAdAssetCombinationView 现支持 RESPONSIVE_DISPLAY_AD 的展示量、表现及转化指标。
- 地理与门店视图:UserLocationView 和 GeographicView 支持按转化日期细分;新增 PerStoreView 查询门店详情,以及 MatchedLocationInterestView 用于 AI Max 活动的地理位置兴趣细分。
激励措施编程化支持
- CYO 激励获取与应用:新增 FetchIncentive 方法,支持根据国家、语言及邮箱获取个性化“自选”(CYO)激励;ApplyIncentive 方法允许将选定激励应用于指定客户账户。
- 已兑换激励查询:新增只读资源 AppliedIncentive,可通过 Search 接口查询激励状态、履行进度、奖励金额及日期等详细信息。
- 错误处理优化:IncentiveErrorEnum 新增相关错误代码,AuthenticationErrorEnum 新增 INVALID_EMAIL_ADDRESS,以支持更细粒度的故障管理。
规划与受众洞察智能化
- AI 生成受众定义:AudienceInsightsService.GenerateAudienceDefinition 利用生成式 AI,将自由文本描述自动转换为匹配的受众属性。
- 生活事件维度:AudienceInsightsDimension 新增 LIFE_EVENT_USER_INTEREST,支持基于生活事件构建受众群体。
- 转化率预测细化:ReachPlanService.GenerateConversionRates 响应包含展示面(如 Gmail、Shorts)信息,仅适用于 Demand Gen 活动。
- 行业基准对比:新增 BenchmarksService,支持将 YouTube 广告数据与行业基准进行对标分析。
- 创作者相关性评分:YouTubeChannelInsights 新增 relevance_score,基于观看次数加权评估创作者主题相关性;新增 LanguageDistribution 提供频道内容语言分布。
- 趋势变化指标:TrendInsightMetrics 新增 trend_change_percent,反映比较期内的趋势百分比变化。
各模块详细技术变更
广告与资产
- 广告格式:AdFormatType 新增 TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION;移除 CallAd 和 CallAdInfo 支持。
- 共享限制:AdGroupAdErrorEnum 新增 AD_SHARING_NOT_ALLOWED,禁止跨广告组共享广告。
- 资产指标扩展:asset_group 报告新增 engagements、engagement_rate、average_cpe;asset_group_asset 报告新增 average_cpm、trueview_average_cpv、video_trueview_view_rate 等视频互动指标。
- 字段更新:图片/视频资产新增只读 orientation 字段;支持获取 HEADLINE 和 DESCRIPTION 类型的 CampaignAsset;ServedAssetFieldType 新增站点链接相关位置字段;Business Message Assets 已更新。
计费与转化
- 账单明细:ListInvoicesRequest 支持 include_granular_level_invoice_details,返回广告系列级成本细分、监管费用及调整信息;新增 RegulatoryFeeTypeEnum 和 UnitOfMeasureEnum。
- 转化追踪:ConversionActionCategory 新增 YOUTUBE_FOLLOW_ON_VIEWS,支持追踪观看广告后继续观看同频道视频的行为。
广告系列与需求生成
- 时间控制:Campaign 新增 start_date_time 和 end_date_time 替换原有日期字段,支持指定时间组件;新增 DURATION_TOO_LONG_FOR_TOTAL_BUDGET 等预算时长校验错误码。
- Demand Gen:DemandGenVideoResponsiveAdInfo 新增 companion_banner 字段;DemandGenMultiAssetAdInfo 移除 lead_form_only 字段。
推荐与购物
- 新客户推荐:GenerateRecommendationsRequest 新增 is_new_customer 字段,针对无历史广告系列的账户使用专用模型生成 CAMPAIGN_BUDGET 推荐。
- 购物性能指标:ShoppingPerformanceView 支持按转化日期细分的转化量、价值及单次转化价值指标;新增搜索预算丢失、排名丢失等竞争指标。
- 商品信息:ShoppingProduct 新增 product_image_uri 字段。
垂直广告与视频
- 旅游垂直广告:Search 活动 AdGroup 新增 vertical_ads_format_setting 控制投放格式;AdGroupCriterion 和 SharedCriterion 支持 vertical_ads_item_group_rule_list/rule 定向商品组;支持连接 AI Max 活动并在报告中按 AdFormatType 及数据源维度细分。
- 视频广告:AdVideoAssetInfo 新增 ad_video_asset_feature_control 字段;CampaignCriterionError 新增 INVALID_VIDEO_LINEUP_ID;YouTube 音频广告新增可听度指标及可测量展示次数统计。
其他变更
- 报告清理:移除聚合资产表现标签指标,Search 和 Display 不再返回表现标签枚举值。
- API 停用提醒:AdWords API 已于 2025 年 4 月 27 日停用,并将于 7 月底完全停止服务,请尽快迁移至 Google Ads API。

