
Google 正式宣布推出 Google Ads API v11。此前,v10.1 版于 2022 年 4 月 27 日发布,v10.0 版于同年 2 月 9 日上线。随着 AdWords API 已于 4 月 27 日停用并将于 7 月底彻底停止运行,本次 v11 版本的更新对开发者及广告优化师至关重要。
核心功能模块变更
资产与受众群体
- 资产来源追踪:新增 AssetSource 字段,用于标识资产或资产链接的生成主体。该信息现已在 Asset、CustomerAsset、CampaignAsset 及 AdGroupAsset 中通过 source 字段提供。
- 受众规则调整:移除 DateSpecificRuleUserListInfo 和 RuleBasedUserListInfo.date_specific_rule_user_list。
出价策略优化
- 字段重命名:MaximizeConversions.target_cpa 已重命名为 target_cpa_micros;AccessibleBiddingStrategy 中的对应字段也同步完成更名。
广告系列管理升级
- 智能广告系列(Smart Campaigns):
- 新增 SmartCampaignSetting.ad_optimized_business_profile_setting 及 AdOptimizedBusinessProfileSetting,支持使用针对广告优化的商业资料作为着陆页。
- 新增 SmartCampaignSetting.business_profile_location,用于关联 Google 商家资料位置资源名称;原 business_location_id 字段已被取代并移除。
- Performance Max 升级:新增 Campaign.performance_max_upgrade 字段(类型:PerformanceMaxUpgrade),用于展示广告系列升级状态;建议使用 UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation 发起升级。
- 指标扩展:search_click_share 指标现已支持 Performance Max 广告系列。
- 本地服务广告系列(Local Services):
- 新增 ManualCpa 出价策略及 Campaign.local_services_campaign_settings(类型:LocalServicesCampaignSettings)。
- 支持通过 LocalServicesCampaignSettings.category_bids 设置 ManualCpa 出价。
- 支持将最大化转化设为标准出价策略,并支持将广告排期作为广告系列条件。
数据规划与报告增强
关键词与受众洞察规划
- 广告组主题生成:KeywordPlanIdeaService 新增 GenerateAdGroupThemes 方法,可根据提供的关键词和广告组列表,返回修改建议(含文本、匹配类型)及推荐放置的广告组。
- 受众洞察(白名单功能):AudienceInsightsService 新增两个方法:GenerateInsightsFinderReport(创建受众洞察报告链接)和 ListAudienceInsightsAttributes(发现洞察主题或类别)。
覆盖范围预测(Reach Forecast)
- 联合观看指标:为 ReachForecast 及 PlannedProductForecast 新增多个字段,包括目标/总覆盖触达、目标/总共同观看展示次数,以及有效频率分解中的有效联合覆盖触达等。
- 请求选项:新增 ForecastMetricOption.include_coview 标志位,用于在 GenerateReachForecastRequest 中请求包含上述共视指标。
购物广告设置
- Feed 标签匹配:ShoppingSetting 新增 feed_label 字段,提供更灵活的方式将广告系列与商家数据源匹配。该字段取代了 sales_country 的功能(两者暂共存但互斥),目前仅限白名单账户使用。
系统配置与兼容性调整
转化跟踪与实验
- Firebase 集成:FirebaseSettings 新增 property_id 和属性名称字段。
- 错误代码更新:新增 ORDER_ID_CONTAINS_PII 相关上传错误提示;移除外归因转化类型与 BRAID 不兼容的错误代码。
- 实验类型:移除 ExperimentType.SMART_DISPLAY。
推荐系统与报告
- 新推荐项:新增 ResponsiveSearchAdImproveAdStrengthRecommendation(响应式搜索广告强度提升建议)及 UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation。
- 报告兼容性:segments.asset_interaction_target 下的 asset 和 interaction_on_this_asset 字段现已兼容 ad_group 和 campaign 维度。
标准限制
- 新增 SettingError.BID_ONLY_IS_NOT_ALLOWED_TO_BE_MODIFIED_WITH_CUSTOMER_MATCH_TARGETING,明确客户匹配定位下仅允许修改出价的限制。

