最低功能要求

版本号:2022-10-06

最低功能要求 (RMF) 是指某些工具开发者在使用 Google Ads API 时必须提供的特性及其他功能。如下文所述,RMF 规则分为三类:制作功能、管理功能和报告功能。您是否需要遵守这些规则取决于您使用 Google Ads API 的方式(“RMF 适用”表示 RMF 适用于您):

创建功能 管理功能 报告功能
全方位服务工具
  • 广告客户、代理机构和其他第三方使用您的工具对其 Google Ads 帐号进行全面管理
RMF 适用 RMF 适用 RMF 适用
仅用于报告
  • 最终广告客户只能使用报告信息中心
RMF 不适用 RMF 不适用 RMF 适用
仅限内部使用
  • 仅供单个广告客户或代理机构使用;没有第三方对工具的访问权限(也就是说,只有您自己使用您的工具)
RMF 不适用 RMF 不适用 RMF 不适用

如果您的工具提供的功能非常有限且较为专业,并且不能用于制作和管理广告系列、广告组和广告,则其可能不符合全方位服务工具的条件。在这种情况下,制作和管理方面的 RMF 均不适用。如果您不确定 RMF 政策是否适用于您的工具,请与 Google Ads API 合规团队联系。Google Ads API 合规团队将确定您的工具是否属于全方位服务工具。如果您的工具的功能发生显著变化,则可能需要重新评估该工具。

请注意,RMF 仅适用于拥有标准权限的开发者令牌。

针对重大更新的一次性延期

由于 API 工具可能会定期执行大范围的技术升级,为此,如果特定工具至少连续 2 年都在每个截止日期前达到了最低功能要求,则可以申请 6 个月的延期,以便在其平台中实施此类升级。延期申请获得批准后,我们在延期的这段时间内不会再对相关工具进行最低功能要求合规审核。延长期结束时,工具必须完全符合延长期的最后一天当天或之前到期的所有 RMF 要求。在延期结束后,所有 RMF 要求的截止日期仍为下表中指定的日期。

每个 API 工具每四年最多可以获得一次延期(第二次延期必须在第一次延期结束至少 4 年后开始)。

如果您想为您的工具申请延期,请通过 https://support.google.com/adspolicy/contact/contact_ads_api 与我们联系,申请使用申请表。您的申请必须由贵公司的高管(首席执行官、首席技术官或高级副总裁)签署并提交。请注意,我们并不保证您的申请一定会获得批准。

“仅限购物广告”“仅限应用宣传”和“仅限酒店”API 工具的相关要求

如果您的工具仅用于创建和管理以下广告系列类型,那么您只需实现 Google Ads API 创建和管理功能以及最低功能要求中适用于相应广告系列类型的报告即可。

仅用于报告的 Google Ads API 客户端须满足的要求

为了满足 RMF 的要求,仅用于报告的 Google Ads API 客户端必须为报告界面中显示的 Google Ads 层级结构的每一级都显示报告功能。Google Ads 层级结构中的层级可以是帐号层级、广告系列层级、广告组层级、广告层级或关键字层级。例如,如果仅用于报告的 Google Ads 客户端显示了广告组,就必须实现以下标记为“必选”的所有“广告组”级报告功能。

仅用于报告的 Google Ads API 客户端可以选择在报告界面中不显示 Google Ads 层级结构的特定层级。例如,如果仅用于报告的 Google Ads API 客户端在其界面中未显示任何广告组效果数据,则不需要实现任何“广告组”层级的报告最低功能要求。

上述政策同样适用于其他所有报告类型(尽管这些报告类型并非 Google Ads 层级结构的组成部分)。如果您选择实现上述任何报告,则必须显示针对各报告的所有必选字段。

为了满足 RMF 的要求,Google Ads API 客户端必须默认显示每个报告的“对象/字段/指南”列中标记为必选的所有列。其他所有指标列必须作为候选内容提供,由 Google Ads API 客户端用户自行选择取舍。Google Ads 报告数据应该足够醒目,方便最终用户访问。

可下载的报告

如果您的工具提供下载选项(例如 CSV),而不是在界面中显示报告功能,则必须突出显示下载链接并直观地加以标记。下载的文件必须包含所有必选的报告字段并带有清楚的标记。

报告日期范围

我们建议您允许用户按日期范围过滤报告数据。如果您的工具不支持自定义日期范围,则至少应该为每个必选报告字段提供最近 30 天的数据。

提供创建功能或管理功能的API客户端须满足的要求

为了满足 RMF 的要求,提供全方位服务的 Google Ads API 客户端必须实现下表中所有必需的创建和管理功能,并为以下每种报告显示报告功能。此外,您必须采取合理措施,确保最终广告客户(根据这些功能的使用情况衡量)可轻松访问并使用上述各项功能。

提供规划服务的 API 客户端须满足的要求

如果 Google Ads API 客户端提供了与 KeywordPlanIdeaService 或 KeywordPlanService 相关的任何功能,则该客户端必须完全实现下表中标为“必选”的必选创建功能、管理功能和报告功能。

提供建议服务的 API 客户端须满足的要求

所有 API 客户端都可以使用 GoogleAdsService 和 RecommendationService 获取推荐内容。

只有以下类型的 Google Ads API 客户端才能使用 RecommendationService.ApplyRecommendation()RecommendationService.DismissRecommendation()

  • 全方位服务工具
  • 仅供内部使用的工具
  • 仅限购物广告系列、仅限效果最大化广告系列 / 智能购物广告系列、仅限应用宣传和酒店专用 API 工具
  • 提供广告系列管理功能的专用工具

如果 Google Ads API 客户端提供使用 RecommendationService 采纳或拒绝建议的功能,则它必须满足以下要求:

  1. 必须完全实现其工具类别所要求的创建功能、管理功能和报告功能。
  2. 向最终用户显示的所有 Google Ads 建议都必须在工具界面中以“Google Ads 建议”的形式显示。
  3. 最终用户必须能够查看和应用 Google Ads API 客户端显示的所有 Google Ads 建议。

与出价调整相关的要求

所有提供创建或管理功能的 API 客户端都必须满足以下与出价调整相关的要求:

  1. 最终用户必须能够输入允许的值范围内的所有值。
  2. 最终用户必须能够在 Google Ads API 客户端设置出价调整之前,先行查看和修改出价调整。
  3. 出价调整只能表示为出价调整,不得用于启用或模拟其他功能,例如定位或排除。

功能实现

除非下文另有规定,否则,当且仅当所有可用子功能和参数也一并实现时,相应功能才算实现。API 参考文档记录了可用的参数和子功能。例如,“选择加入/退出投放网络”功能意味着支持选择加入/退出 Google 搜索、搜索网络合作伙伴和展示广告网络。此外,如果您在 Google Ads API 客户端中实现了与 Google 非要求的功能类似的功能,则还必须在您的 Google Ads API 客户端中实现类似的 Google 功能。例如,如果您在 Google Ads API 客户端中实现了自己的“关键字提示”,您就必须同时在 Google Ads API 客户端中实现 Google 的“关键字提示”功能。

为了与 RMF 规定保持一致,任何新的必需功能都必须在截止日期(显示在每项功能旁边,格式为:到期日:YYYY-MM-DD)之前添加。任何未指定截止日期的最低 RMF 均已过期。另外,如果您要对 Google Ads API 客户端进行重大更改,我们要求您至少在更改生效的两周之前,使用工具更改表单发送相应建议更改的屏幕截图和/或模型。为明确起见,特此说明:在这两周的时间过去之后,您无需等待 Google 的回复,这些更改就会生效。

全方位服务工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能

C.10 制作广告系列 campaign 必需
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关,可以选择向用户显示。
C.30 启用语言定位 campaign_criterion.language
language_constant
必需。如果只有一种语言与用户群相关,可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少提供一种类型的转化跟踪。
C.75 附加宣传信息 宣传信息 Feed 占位符
附加信息设置服务
Feed 服务
必需。需要仅在帐号级别支持该功能。
C.96 设置出价选项:目标每次转化费用(“组合”和“标准”) campaign.target_cpa(标准版)
bidding_strategy.target_cpa(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
C.97 设置出价选项:目标广告支出回报率(“组合”和“标准”) campaign.target_roas(标准版)
bidding_strategy.target_roas(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
C.98 设置出价选项:尽可能提高转化次数(标准) campaign.maximize_conversions(标准) 必需
C.120 设置预算 campaign_budget 必需
C.190 制作广告组 ad_group 必需。可选:能够创建多个广告组。
C.260 添加关键字 ad_group_criterion.keyword 必需
C.270 添加广告系列否定关键字 campaign_criterion.negative 必需
C.300 设置关键字匹配类型 ad_group_criterion.keyword
 .match_type
必需

管理功能

M.10 修改广告系列设置 campaign.*setting 必需。只有创建时所需的设置在更改时才需要。
M.96 修改出价选项:目标每次转化费用(“组合”和“标准”) campaign.target_cpa(标准版)
bidding_strategy.target_cpa(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
M.97 修改出价选项:目标广告支出回报率(“组合”和“标准”) campaign.target_roas(标准版)
bidding_strategy.target_roas(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
M.98 修改出价选项:尽可能提高转化次数(标准) campaign.maximize_conversions(标准) 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.130 暂停/启用/移除广告 ad_group_ad.status 必需
M.140 暂停/启用/移除关键字 ad_group_criterion.status 必需

报告功能

R.10 客户 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
必需
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
必需
campaign.status 如果要显示已暂停、有效以及已移除状态的广告系列,则为必选。
如果只显示有效的广告系列,则为可选。
R.40 广告组广告 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
必需
ad_group_ad.status 如果要显示已暂停、有效以及已移除状态的广告,则为必选。
如果只显示有效的广告,则为可选。
R.50 关键字视图 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
ad_group_criterion
 .position_estimates
 .first_page_cpc_micros

ad_group_criterion
 .position_estimates
 .first_position_cpc_micros
必需
ad_group_criterion.status 如果要显示已暂停、有效以及已移除状态的关键字,则为必选。
如果只显示有效的关键字,则为可选。
R.70 搜索字词视图 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
必需
R.100 动态搜索广告搜索字词视图 dynamic_search_ads_search_term_view.search_term
metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
仅在实现动态搜索广告时才需要。
R.130 出价策略 bidding_strategy.type
metrics.clicks
metrics.cost_micros
metrics.cost_per_conversion
metrics.impressions
metrics.average_cpc
metrics.conversions
必需
bidding_strategy.status 如果要显示已暂停、有效以及已移除状态的策略,则为必选。
如果只显示有效的策略,则为可选。

应用广告系列工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能

C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关,可以选择向用户显示。
C.30 启用语言定位 campaign_criterion.language
language_constant
必需。如果只有一种语言与用户群相关,可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少提供一种类型的转化跟踪。
C.96 设置出价选项:目标每次转化费用(“组合”和“标准”) campaign.target_cpa(标准版)
bidding_strategy.target_cpa(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
设置出价选项:预注册 以吸引用户预注册为目标的应用广告 对于应用预注册广告系列是必需的。
C.190 制作广告组 ad_group 必需。可选:制作多个广告组。
为广告组添加素材资源 ad_group 必需:文字素材资源。对于图片和视频素材资源,此参数可选。
C.601 制作安装或再互动 应用广告系列   必需:应用安装广告系列或应用广告系列再互动,但二者不能同时满足。
C.602 启用应用广告系列设置 AppCampaignSetting 必需:能够选择要宣传的应用或添加深层链接以吸引用户互动。

管理功能

M.601 暂停 / 启用 / 移除应用广告系列 campaign.status 必需
M.602 修改应用广告系列设置 campaign.*setting 必需

报告功能

R.10 帐号效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
必需
R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
如果要显示已暂停、有效以及已移除状态的广告系列,则为必选。
如果只显示有效的广告系列,则为可选。

“仅限酒店广告”工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能

C.11 制作酒店广告系列 酒店广告系列 必需
C.12 为酒店广告系列设置 Hotel Center 标识符 HotelSettingInfo 必需
C.20 启用地理位置定位 地理位置定位 必需 在只有一个国家/地区与用户群相关时,视需要向用户显示。
C.30 启用语言定位 campaign_criterion.language
language_constant
必需。如果只有一种语言与用户群相关,可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少提供一种类型的转化跟踪。
C.120 设置预算 campaign_budget 必需
  设置出价策略 酒店出价 (可选)允许用户选择特定出价策略并设置目标。
C.190 制作酒店广告组 ad_group 必需。可选:能够创建多个广告组。
C.526 添加第一个(根)分区酒店组分区 酒店信息组 对于投放酒店广告系列而言,是必需的,但不需要向用户显示。

管理功能

M.10 修改广告系列设置 campaign.*setting 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.161 细分(添加酒店组划分) 酒店商家信息组 必需
M.191 排除酒店组 AdGroupCriterion 必需

报告功能

R.10 帐号效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
必需
R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
如果要显示已暂停、有效以及已移除状态的广告系列,则为必选。
如果只显示有效的广告系列,则为可选。
R.111 “酒店效果视图”报告 hotel_performance_view 必需

效果最大化广告系列功能列表

商品编号 功能 对象/字段/指南 要求

创建功能

C.10 制作广告系列 campaign 必需。可选:能够制作多个广告系列。
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关,可以选择向用户显示。
C.30 启用语言定位 campaign_criterion.language
language_constant
必需。如果只有一种语言与用户群相关,可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少提供一种类型的转化跟踪。
C.120 设置预算 campaign_budget 必需
  设置出价策略   (可选)允许用户选择特定出价策略并设置目标。

管理功能

M.10 修改广告系列设置 campaign.*setting 必需。只有创建时所需的设置在更改时才需要。
M.110 暂停/启用/移除广告系列 campaign.status 必需

报告功能

R.10 客户 metrics.clicks
metrics.cost_micros
metrics.conversions
必需。如果只显示一个广告系列,则为可选。
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.conversions
必需

智能广告系列功能列表

下表列出了投放智能广告系列所需的最低功能集。如果您的工具根本实现了智能广告系列,则您必须至少实现这组功能。如果您的工具未实施智能广告系列,则无需使用这些功能。

商品编号 功能 对象/字段/指南 要求

创建功能

C.10 制作智能广告系列 智能广告系列 必需
  添加关键字主题 KeywordThemeInfo 创建广告系列时必填,但可选择是否向用户显示。
C.20 启用地理位置定位 地理位置定位 创建广告系列时必填,但可选择是否向用户显示。
C.70 地址素材资源 地址素材资源 仅在与商家资料集成时才需要。
C.120 设置预算 campaign_budget 必需
C.200 添加广告 制作广告 创建广告系列时必填,但可选择是否向用户显示。

管理功能

M.10 修改广告系列设置(向广告客户显示所有广告系列制作设置) campaign.*setting 必需
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.130 暂停/启用/移除广告 ad_group_ad.status 必需
  设置 / 修改广告系列投放时间 ad_schedule 必需
  移除 / 添加关键字主题 KeywordThemeInfo 创建广告系列时必填,但可选择是否向用户显示。
  添加/移除否定关键字主题 KeywordThemeInfo 创建广告系列时必填,但可选择是否向用户显示。

报告功能

R.20 广告系列效果 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversions
metrics.all_conversions
如果要显示已暂停、有效以及已移除状态的广告系列,则为必选。 如果只显示有效的广告系列,则为可选。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
仅在与商家资料集成时才需要。
R.70 智能广告系列搜索字词视图 metrics.clicks
metrics.cost_micros
必需

标准购物广告系列工具功能列表

商品编号 功能 对象/字段/指南 要求

创建功能

C.10 制作广告系列 campaign 必需
C.20 启用地理位置定位 地理位置定位 必需。 如果只有一个国家/地区与用户群相关,可以选择向用户显示。
C.65 创建网站 / 来电转化并生成代码段 转化跟踪 必须至少提供一种类型的转化跟踪。
C.97 设置出价选项:目标广告支出回报率(“组合”和“标准”) campaign.target_roas(标准版)
bidding_strategy.target_roas(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
C.120 设置预算 campaign_budget 必需
C.190 制作广告组 ad_group 必需。可选:能够创建多个广告组。
C.270 添加广告系列否定关键字 campaign_criterion.negative 必需
C.300 设置关键字匹配类型 ad_group_criterion.keyword
 .match_type
必需
C.505 设置商家 ID   必需
C.506 设置销售国家/地区   必需
C.510 设置产品目录过滤条件   必需
C.520 制作产品广告   必需
C.525 添加首个(根)产品划分   必需
C.530 制作本地商品目录广告   必需

管理功能

M.10 修改广告系列设置 campaign.*setting 必需。只有创建时所需的设置在更改时才需要。
M.97 修改出价选项:目标广告支出回报率(“组合”和“标准”) campaign.target_roas(标准版)
bidding_strategy.target_roas(组合策略)
必需。“组合”策略和“标准”策略都需要在广告系列一级提供支持。
M.110 暂停/启用/移除广告系列 campaign.status 必需
M.150 修改产品目录过滤条件   必需
M.160 细分(添加产品划分)   必需
M.170 删除产品划分   必需
M.190 排除产品划分   必需

报告功能

R.10 客户 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
必需。如果只显示一个广告系列,则为可选。
R.20 广告系列 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
必需
R.70 搜索字词视图 search_term_view.search_term
segments.search_term_match_type
metrics.clicks
metrics.cost_micros
metrics.impressions
必需
R.110 购物效果报告 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
仅在实现动态搜索广告时才需要。
R.120 产品划分 metrics.clicks
metrics.cost_micros
metrics.impressions
metrics.conversion_value
必需。如果商品未细分,则为可选属性
R.130 出价策略效果   必需。如果商品未细分,则为可选属性