最低功能要求 (RMF) 是指某些工具开发者在使用 Google Ads API 时必须提供的特性及其他功能。如下所述,RMF 规则分为三类:制作功能、管理功能和报告功能。您是否需要遵守这些规则取决于您使用 Google Ads API 的方式(“RMF 适用”表示 RMF 适用于您):
| 创建功能 | 管理功能 | 报告功能 | |
|---|---|---|---|
全方位服务工具
|
RMF 适用 | 适用 RMF | RMF 适用 |
仅用于报告
|
RMF 不适用 | 不适用 RMF | RMF 适用 |
仅限内部使用
|
RMF 不适用 | 不适用 RMF | RMF 不适用 |
如果您的工具提供非常有限且较为专业的功能,并且不能用于制作和管理广告系列、广告组和广告,则其可能不符合全方位服务工具的条件。在这种情况下,制作和管理方面的 RMF 均不适用。如果您不确定 RMF 政策是否适用于您的工具,请与 Google Ads API 合规团队联系。Google Ads API 合规团队将确定您的工具是否属于全方位服务工具。如果您的工具的功能发生显著变化,则可能需要重新评估该工具。
请注意,RMF 仅适用于具有标准访问权限级别的 Google Cloud 项目。
重大更新的一次性延期
由于 API 工具可能会定期执行大范围的技术升级,为此,如果特定工具至少连续 2 年都在每个截止日期前达到了最低功能要求,则可以申请 6 个月的延期,以便在其平台中实施此类升级。延期申请获得批准后,我们在延期的这段时间内不会再对相关工具进行最低功能要求合规审核。在延期结束时,该工具必须完全符合在延期最后一天或之前到期的所有 RMF 要求。所有在延期结束后到期的 RMF 要求仍将在下表指定的日期到期。
每四年最多可为 API 工具授予一次延期(第二次延期必须在第一次延期结束至少 4 年后开始)。
如果您想为自己的工具申请延期,请与 Google Ads API 合规团队联系,索取申请表单。您的申请必须由贵公司的高管(首席执行官、首席技术官或高级副总裁)签署并提交。 请注意,您的申请不一定会获得批准。
仅适用于购物广告系列、仅适用于应用宣传广告系列和仅适用于酒店广告系列的 API 工具的要求
如果您的工具仅用于制作和管理以下其中一种广告系列,那么您只需在 RMF 中实现适用于该广告系列类型的 Google Ads API 制作和管理功能以及报告。
- 应用宣传广告系列
- 酒店广告系列(仅在 Google Ads API 中提供)
- 效果最大化广告系列(仅在 Google Ads 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 客户端在其界面中不显示任何广告组效果数据,则无需实现任何“广告组”级报告 RMF。
上述政策同样适用于其他所有报告类型(尽管这些报告类型并非 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 来检索建议。
RecommendationService.ApplyRecommendation() 和 RecommendationService.DismissRecommendation() 的使用仅限于以下类型的 Google Ads API 客户端:
- 全方位服务工具
- 仅限内部使用的工具
- 仅限购物广告系列、仅限效果最大化广告系列/智能购物广告系列、仅限应用宣传广告系列和仅限酒店广告系列的 API 工具
- 提供广告系列管理功能的专用工具
如果 Google Ads API 客户端提供使用 RecommendationService 采纳或拒绝建议的功能,则必须满足以下要求:
- 必须完全实现其工具类别所需的制作功能、管理功能和报告功能。
- 向最终用户显示的所有 Google Ads 建议都必须在工具界面中显示为“Google Ads 建议”。
- 最终用户必须能够查看和采纳 Google Ads API 客户端显示的所有 Google Ads 建议。
出价调整要求
所有提供创建或管理功能的 API 客户端都必须满足以下与出价调整相关的要求:
- 最终用户必须能够输入允许的值范围内的所有值。
- 最终用户必须能够先查看和修改出价调整,然后才能由 Google Ads API 客户端进行设置。
- 出价调整只能表示为对出价的调整,不得用于启用或近似实现其他功能,例如定位或排除。
功能实现
除非下文另有规定,否则,当且仅当所有可用子功能和参数也一并实现时,相应功能才算实现。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 |
必需。如果用户群只使用一种语言,则可选择向用户显示。 |
| 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 |
必填 |
管理功能 |
|||
| 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.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions
|
必填 |
| R.20 | 广告系列 |
metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions |
必填 |
campaign.status |
如果显示已暂停、有效和已移除的广告系列,则必须提供此字段。 如果仅显示有效广告系列,则此参数为可选。 |
||
| R.40 | 广告组广告 |
metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions
|
必填 |
ad_group_ad.status |
如果显示已暂停、有效和已移除的广告,则必须提供。 如果仅显示有效广告,则此参数为可选。 |
||
| R.50 | 关键字视图 |
metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsad_group_criterionad_group_criterion
|
必填 |
ad_group_criterion.status |
如果显示已暂停、有效和已移除的关键字,则必须提供此参数。 如果仅显示有效关键字,则此参数为可选。 |
||
| R.70 | 搜索字词视图 |
search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions
|
必填 |
| R.100 | 动态搜索广告搜索字词视图 |
dynamic_search_ads_search_term_view.search_termmetrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions
|
仅在采用动态搜索广告时才需要。 |
| R.130 | 出价策略 |
bidding_strategy.typemetrics.clicksmetrics.cost_microsmetrics.cost_per_conversionmetrics.impressionsmetrics.average_cpcmetrics.conversions
|
必填 |
bidding_strategy.status |
如果要显示已暂停、有效以及已移除状态的策略,则为必选。 如果仅显示有效策略,则此参数为可选。 |
||
应用广告系列工具功能列表
| 项目编号 | 功能 | 对象/字段/指南 | 要求 |
|---|---|---|---|
创建功能 |
|||
| C.20 | 启用地理位置定位 | 地理位置定位 | 必需。 如果用户群仅与一个国家/地区相关,则可选择向用户显示。 |
| C.30 | 启用语言定位 | campaign_criterion.language |
必需。如果用户群只使用一种语言,则可选择向用户显示。 |
| 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.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions
|
必填 |
| R.20 | 广告系列效果 |
metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions |
如果显示已暂停、有效和已移除的广告系列,则必须提供此字段。 如果仅显示有效广告系列,则此参数为可选。 |
仅限酒店的工具功能列表
| 项目编号 | 功能 | 对象/字段/指南 | 要求 |
|---|---|---|---|
创建功能 |
|||
| C.11 | 制作酒店广告系列 | 酒店广告系列 | 必填 |
| C.12 | 为酒店广告系列设置 Hotel Center 标识符 |
HotelSettingInfo |
必填 |
| C.20 | 启用地理位置定位 | 地理位置定位 | 必需 如果只有一个国家/地区与用户群相关,则可选择向用户公开。 |
| C.30 | 启用语言定位 | campaign_criterion.language |
必需。如果用户群只使用一种语言,则可选择向用户显示。 |
| 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.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions
|
必填 |
| R.20 | 广告系列效果 |
metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions |
如果显示已暂停、有效和已移除的广告系列,则必须提供此字段。 如果仅显示有效广告系列,则此参数为可选。 |
| R.111 | 酒店效果视图报告 |
hotel_performance_view
|
必填 |
效果最大化广告系列功能列表
| 项目编号 | 功能 | 对象/字段/指南 | 要求 |
|---|---|---|---|
创建功能 |
|||
| C.10 | 制作广告系列 | campaign |
必需。可选:能够创建多个广告系列。 |
| C.20 | 启用地理位置定位 | 地理位置定位 | 必需。 如果用户群仅与一个国家/地区相关,则可选择向用户显示。 |
| C.30 | 启用语言定位 | campaign_criterion.language |
必需。如果用户群只使用一种语言,则可选择向用户显示。 |
| C.65 | 创建网站/来电转化并生成代码段 | 转化跟踪 | 必须至少采用一种转化跟踪。 |
| C.120 | 设置预算 | campaign_budget |
必填 |
| 设置出价策略 | (可选)允许用户选择特定的出价策略并设置目标值。 | ||
管理功能 |
|||
| M.10 | 修改广告系列设置 | campaign.*setting |
必需。只有在创建时必需的设置才会在更改时成为必需设置。 |
| M.110 | 暂停/启用/移除广告系列 | campaign.status |
必填 |
报告功能 |
|||
| R.10 | 客户 | metrics.clicksmetrics.cost_microsmetrics.conversions |
必需。如果仅显示一个广告系列,则此字段为可选字段。 |
| R.20 | 广告系列 | metrics.clicksmetrics.cost_microsmetrics.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.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions |
如果显示已暂停、有效和已移除的广告系列,则必须提供。 如果仅显示有效的广告系列,则此参数为可选。 |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONS
|
仅在与商家资料集成时才需要。 | ||
| R.70 | 智能广告系列搜索字词视图 |
metrics.clicksmetrics.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 |
必填 |
| 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.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value |
必需。如果仅显示一个广告系列,则此字段为可选字段。 |
| R.20 | 广告系列 | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value |
必填 |
| R.70 | 搜索字词视图 |
search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions
|
必填 |
| R.110 | 购物表现 | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value |
仅在采用动态搜索广告时才需要。 |
| R.120 | 产品划分 | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value |
必需。如果商品未细分,则为可选 |
| R.130 | 出价策略效果 | |
必需。如果商品未细分,则为可选 |