
谷歌近期发布了 Google Ads API 第15版。此次更新距上一版本(v14.1)已有数月,属于重大迭代。核心变化涵盖新增推荐类型、Performance Max 广告系列功能升级、相似受众细分支持以及离线转化上传诊断优化等。值得注意的是,随着新版API的推出,旧版 AdWords API 已于今年4月停用,并将于7月底彻底停止运行。
账户管理与资产优化
账户状态与链接管理
- 暂停状态修正:若账户因未授权活动被暂停,customer.status 和 customer_client.status 字段现在将正确返回 SUSPENDED(此前错误返回 ENABLED)。
- Merchant Center 链接重构:新增 ProductLink.merchant_center 及 MerchantCenterIdentifier,支持在 Google Ads 与 Merchant Center 间添加或移除链接;原 MerchantCenterLinkService 已移除,请改用 ProductLinkInvitationService 和 ProductLinkService。
- Hotel Center 链接更新:移除了 AccountLink.hotel_center 及相关服务,更新 Hotel Center 链接邀请需统一使用 ProductLinkInvitationService。
图片资产与商品组过滤器
- 图片资产标准化:ImageAdInfo.media_file 替换为 ImageAdInfo.image_asset,以支持通过资产库管理图片,MediaFileService 随之移除。
- 商品组过滤增强:新增 ListingGroupFilterDimension.webpage,支持基于自定义标签和 URL 子字符串创建过滤器;AssetGroupListingGroupFilter.vertical 替换为 listing_source 及对应枚举值。
- 资产来源追踪:asset_group_asset.source 和 ad_group_ad_asset_view.source 字段上线,可清晰显示商品组及广告组资产的来源。
受众群体与广告系列策略
隐私合规与相似受众
- 同意声明支持:Customer Match 和 Store Sales 分别新增 consent 字段,用于提供用户同意声明(目前无需操作,后续将逐步生效)。
- 类似受众(Lookalike):UserList.lookalike_user_list 上线,允许基于种子受众创建类似受众,该功能仅限 Demand Gen 广告系列使用。
Performance Max 与定向升级
- PMax 信号精准化:AssetGroupSignal.audience 新增 scope 和 asset_group 字段,可将受众限定在特定资产组内;新增 search_theme 条件类型,支持在 PMax 中使用搜索主题定向。
- 政策豁免与报告:添加 exempt_policy_violation_keys 支持信号添加时的违规豁免请求;新增 asset_group_top_combination_view 报告,用于分析资产组层面的最佳组合表现。
- 品牌建议服务:BrandSuggestionService 可根据前缀推荐品牌,生成的 BRAND 条件可作为搜索广告的定向条件或 PMax 的排除条件。
- 出价模拟调整:Demand Gen 和 Discovery Target CPA 广告系列的模拟数据中,互动次数(interactions)替代了原有的点击次数(clicks)。
转化追踪与归因分析
SKAdNetwork 与隐私沙盒
- SKAdNetwork 指标细化:新增 coarse_conversion_value、source_domain 等分段维度,以及 total_conversions、installs 等指标;原 sk_ad_network_conversions 指标更名为 sk_ad_network_installs。
- Android Privacy Sandbox:新增三份跨网络归因报告(campaign、ad_group、network_type),支持无需重定向的共享密钥编码。
离线转化诊断增强
- 上传状态可视化:offline_conversion_upload_client_summary 移至顶层报告,提供成功率、错误百分比等详细诊断信息。
- 作业逻辑分组:UploadConversionAdjustmentsRequest 等接口新增 job_id 参数,支持将多个上传请求归入同一概念性作业。
- 错误码规范化:INVALID_CONVERSION_ACTION 被拆分为 NO_CONVERSION_ACTION_FOUND 和 INVALID_CONVERSION_ACTION_TYPE;新增 INVALID_JOB_ID 校验。
行业垂直功能更新
购物与电商
- 购物车数据指标:新增 orders、average_order_value_micros、gross_profit_micros 等丰富指标,覆盖订单价值、毛利及交叉销售数据,适用于 shopping_performance_view 等多个报告。
- 产品类别去国家化:shopping_performance_view 中的 product_bidding_category 字段全面替换为 product_category,不再依赖国家代码;product_category_constant 返回所有本地化版本。
- 搜索广告限制:禁止在搜索广告系列中添加 Campaign.shopping_setting 和 CampaignCriterion.listing_scope,相关操作将报错。
本地服务与酒店旅游
- 本地服务验证:新增 local_services_lead、lead_conversation 及 verification_artifact 报告,支持查询线索详情、通话录音及执照保险凭证状态。
- 酒店活动指标:travel_activity_view 新增搜索绝对顶部展示份额、预算损失展示份额等精细化排名与预算指标。
规划工具与客户生命周期
Reach Plan 与受众洞察
- 频次与覆盖面:ListPlannableProducts 支持返回 Forecast.views 及 surface_targeting;AdvancedProductTargeting 支持设置 target_frequency_settings。
- 智能推荐:AudienceInsightsService.GenerateSuggestedTargetingInsights 可返回建议的可投放受众。
客户生命周期目标
- 目标配置服务:新增 CustomerLifecycleGoalService 和 CampaignLifecycleGoalService,支持在客户及广告系列层级配置获取目标。
- 约束规则:明确 Performance Max 广告系列不可使用门店销售目标,且不能同时包含门店销售与到店访问目标。
其他重要变更
- 视频定向:支持 Google TV 网络投放;YouTube 定向整合为单一 YOUTUBE 类型,禁止在未定位 YouTube 时单独定位展示网络。
- 推荐订阅:新增 RecommendationSubscriptionService,支持管理 FORECASTING_SET_TARGET_CPA 等季节性或基础出价策略推荐。
- 报告指标:Campaign 级别新增 unique_users 和 average_impression_frequency_per_user 指标。
- 弃用警告:尝试使用已弃用的基于规则的归因模型将触发 CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS 错误。
Google Ads 将于明日迎来成立23周年——它于2000年10月23日推出

