
Google已正式发布Google Ads API v20版本。此次更新包含Demand Gen广告网络类型报告、平台可比转化指标以及Performance Max(PMax)活动级否定关键词等多项重要功能。官方表示,预计2025年内还将推出两个重大版本。使用v20新功能需同步升级客户端库及代码,相关示例将于下周发布。

核心功能更新概览
资产与广告系列管理优化
- 资产报表增强:为asset_group报表新增多项指标列与细分维度,提升数据分析颗粒度。
- PMax否定关键词支持:Performance Max活动现已支持添加和更新活动级别的否定关键词,助力更精准的流量控制。
转化追踪与合规调整
- 跨账户转化追踪:支持更新现有客户的google_ads_conversion_customer字段,以便加入跨账户转化追踪或更改父级管理账户。
- IP地址匹配限制:新增ClickConversion.user_ip_address字段。需注意,Google Ads不支持对欧洲经济区(EEA)、英国及瑞士用户进行IP地址匹配。开发者需添加逻辑排除上述地区用户的IP共享,并确保数据收集符合隐私政策及法律要求。
Demand Gen与零售建议升级
- 渠道细分支持:ad_network_type细分新增MAPS、GMAIL、DISCOVER值,支持按渠道细分Demand Gen活动。
- 平台可比转化:新增相关指标,便于跨平台效果评估。
- 零售业务建议:GenerateRecommendationsRequest新增merchant_id字段,可针对零售业务而非标准PMax活动生成专属建议。
规划服务与创作者洞察(白名单功能)
以下更新目前仅对白名单账户开放:
- YouTube节目单洞察:AudienceInsightsDimension.YOUTUBE_LINEUP取代YOUTUBE_DYNAMIC_LINEUP,支持检索YouTube Select (YTS) 节目单元数据,相关旧对象已移除。
- 应用实例信息:新增AdditionalApplicationInfo和ApplicationInstance,丰富受众规划维度。
- 设备细分洞察:AudienceInsightsService等新增DEVICE维度,支持按设备类型细分内容创作者数据。
- 创作者聚合指标:GenerateCreatorInsightsResponse新增互动率、平均观看/点赞/分享/评论数、Shorts播放量及品牌连接创作者标识等指标。
- 地理定位细化:ContentCreatorInsightsService支持sub_country_locations字段,允许在国家以下区域进行更精细的创作者洞察搜索。
- 第一方受众触达预测:ReachPlanService新增ListPlannableUserLists接口,支持基于客户自有第一方用户列表生成定制化触达预测。
视频广告格式扩展
- 暂停屏广告:AdFormatType.PAUSE广告现已支持在电视端YouTube有机视频的暂停画面投放并纳入报告。该格式显示于静态视频帧旁,区别于Infeed格式的Demand Gen视频广告。

