最低功能要求 (RMF) 是指某些工具开发者在使用 Google Ads API 时必须提供的特性及其他功能。如下所述,RMF 规则分为三类:创建功能、管理功能和报告功能。您是否需要遵守这些规则取决于您使用 Google Ads API 的方式(“RMF 适用”表示您需要满足该最低功能要求):
创建功能 | 管理功能 | 报告功能 | |
---|---|---|---|
全方位服务工具
|
RMF 适用 | RMF 适用 | RMF 适用 |
仅限报告
|
RMF 不适用 | RMF 不适用 | RMF 适用 |
仅限内部使用
|
RMF 不适用 | RMF 不适用 | RMF 不适用 |
如果您的工具提供非常有限的专用功能,并且不能用于创建和管理广告系列、广告组和广告,则它可能不符合全方位服务的条件。在这种情况下,创建和管理方面的最低功能要求均不适用。如果您不确定最低功能要求是否适用于您的工具,请联系 Google Ads API 合规性审查团队。Google Ads API 合规性审查团队将确定您的工具是否属于全方位服务工具。如果您的工具的功能发生显著变化,则可能需要重新评估该工具。
请注意,最低功能要求仅适用于拥有标准权限的开发者令牌。
针对重大更新的一次性延期
由于 API 工具可能会定期执行大范围的技术升级,为此,如果特定工具至少连续 2 年都在每个截止日期前达到了最低功能要求,则可以申请 6 个月的延期,以便在其平台中实施此类升级。延期申请获得批准后,我们在延期的这段时间内不会再对相关工具进行最低功能要求合规审核。在延长期结束时,该工具必须完全符合在延长期的最后一天或之前到期的所有最低功能要求。延期后到期的所有最低功能要求仍须在下表中指定的日期到期。
每个 API 工具每四年最多只能获得一次延期(第二次延期必须在第一次延期结束后至少 4 年开始)。
如果您想为工具申请延期,请通过以下网址提交申请申请表:https://support.google.com/adspolicy/contact/contact_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 客户端在其界面中未显示任何广告组效果数据,则不需要实现任何“广告组”层级的报告最低功能要求。
上述政策同样适用于其他所有报告类型(尽管这些报告类型并非 Google Ads 层级结构的组成部分)。如果您选择实现上述任何报告,则必须显示针对各报告的所有必选字段。
为了满足 RMF 的要求,Google Ads API 客户端必须默认显示每份报告的“对象/字段/指南”列中标为必填的所有列。其他所有指标列必须作为候选内容提供,由 Google Ads API 客户端用户自行取舍。Google Ads 报告数据应在显眼的位置呈现,方便最终用户访问。
可下载的报告
如果您的工具提供下载选项(例如 CSV),而不是在界面中显示报告功能,则必须突出显示下载链接并直观地加以标记。下载的文件必须包含所有必选的报告字段并带有清楚的标记。
报告日期范围
我们建议您允许用户按日期范围过滤报告数据。如果您的工具不支持自定义日期范围,则至少应该为每个必选报告字段提供最近 30 天的数据。
提供创建功能或管理功能的API客户端须满足的要求
为了满足最低功能要求,提供全方位服务的 Google Ads API 客户端必须实现下表中所有必需的创建和管理功能,并为以下每种报告显示报告功能。此外,您还必须做出合理努力,确保每个功能都能轻松使用,并且可供最终用户按照功能的使用情况来衡量。
对提供规划服务的 API 客户端的要求
如果 Google Ads API 客户端提供了与 KeywordPlanIdeaService 或 KeywordPlanService 相关的任何功能,则该客户端必须完全实现下表中标为“必选”的创建功能、管理功能和报告功能。
提供建议服务的 API 客户端须满足的要求
所有 API 客户端都可以使用 GoogleAdsService 和 RecommendationService 检索建议。
RecommendationService.ApplyRecommendation()
和 RecommendationService.DismissRecommendation()
的使用仅限于以下类型的 Google Ads API 客户端:
- 全方位工具
- 仅限内部使用的工具
- 仅购物广告系列、仅投放智能购物广告系列 / 仅限智能购物广告系列、仅限应用宣传的 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 Ads API 客户端发送相关建议的屏幕截图和/或模拟图。为清楚起见,在两周后,您无需等待 Google 回复,这些实质性更改将会自动生效。
全方位工具功能列表
商品编号 | 功能 | 对象/字段/指南 | 要求 |
---|---|---|---|
创建功能 |
|||
C.10 | 制作广告系列 | campaign |
必需 |
C.20 | 启用地理位置定位 | 地理位置定位 | 必需。 如果只有一个用户群与用户群相关,则可以选择向用户显示。 |
C.30 | 启用语言定位 | campaign_criterion.language |
必需。如果只有一个语言与用户群相关,则可以向用户显示此可选参数。 |
C.65 | 创建网站 / 来电转化并生成代码段 | 转化跟踪 | 必须至少使用一种类型的转化跟踪。 |
C.75 | 附加宣传信息 | 宣传信息 Feed 占位符 附加信息设置服务 Feed 服务 |
必需。该功能仅需要在帐号级别支持。 |
C.80 | 附加链接 | 附加链接 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.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 ad_group_criterion
|
必需 |
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 |
必需。如果只有一个语言与用户群相关,则可以向用户显示此可选参数。 |
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 |
必需。如果只有一个语言与用户群相关,则可以向用户显示此可选参数。 |
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 |
必需。如果只有一个语言与用户群相关,则可以向用户显示此可选参数。 |
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 |
必需 |
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 | 出价策略效果 | |
必需。如果未细分产品,则为可选 |