最低功能要求

最低功能要求

版本号:2017‑05‑31

最低功能要求 (RMF) 是指某些工具开发者在使用 AdWords API 时必须提供的特性及其他功能。如下文所述,最低功能要求规则分为三类:创建功能、管理功能和报告功能。您是否需要遵守这些规则取决于您使用 AdWords API 的方式(“RMF 适用”表示您需要满足该最低功能要求):
创建功能 管理功能 报告功能
全方位服务工具
  • 广告客户、代理机构和其他第三方使用您的工具对其 AdWords 帐号进行全面管理
RMF 适用 RMF 适用 RMF 适用
仅用于报告
  • 最终广告客户只能使用报告信息中心
RMF 不适用 RMF 不适用 RMF 适用
仅限内部使用
  • 仅供单个广告客户或代理机构使用;第三方无法访问该工具(即您是该工具的唯一使用者)
RMF 不适用 RMF 不适用 RMF 不适用

如果您的工具仅提供特定方面的有限功能,并且不能用于创建和管理广告系列、广告组和广告,则不能将其视为全方位服务工具。在这种情况下,创建和管理方面的最低功能要求均不适用。如果您不确定最低功能要求是否适用于您的工具,请联系 AdWords API 合规性审查团队。AdWords API 合规性审查团队将确定您的工具是否属于全方位服务工具。如果您的工具的功能发生了较大变化,则可能需要重新评估。

请注意,最低功能要求仅适用于拥有标准权限的令牌。

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

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

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

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

为了满足最低功能要求,AdWords API 客户端必须为每个报告显示对象/字段/指南列中标记为必选的所有列。其他所有指标列必须作为候选内容提供,由 AdWords API 客户端用户自行取舍。AdWords 报告数据应该适度突出显示,方便最终用户访问。

可下载的报告

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

报告日期范围

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

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

为了满足最低功能要求,提供全方位服务的 AdWords API 客户端必须实现下表中所有必选的创建和管理功能,并为以下每种报告显示报告功能。此外,您还必须采取合理措施来确保上述每项功能的易用性和有效性,这些性能将根据最终广告客户的使用情况来衡量。

仅用于购物广告的 API 工具

如果您的工具仅用于创建和管理购物广告系列,不提供 AdWords 购物广告系列以外的任何其他功能,则您只需实现 AdWords 创建和管理功能以及最低功能要求中用于 Google 购物广告系列的报告功能。要获取这些功能的最新列表,请访问 https://services.google.com/fb/forms/apicontact/,与 AdWords API 合规性审查团队联系。

仅用于应用宣传广告的 API 工具

如果您的工具仅用于制作和管理移动应用宣传广告系列,不提供 AdWords 移动应用宣传广告系列以外的任何其他功能,则您只需实现最低功能要求中适用于 AdWords 移动应用宣传广告系列的 AdWords 创建功能、管理功能和报告功能。要获取这些功能的最新列表,请访问 https://services.google.com/fb/forms/apicontact/,与 AdWords API 合规性审查团队联系。

提供定位参考提示服务或流量估算服务的 API 客户端须满足的要求

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

与出价调整相关的要求

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

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

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

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

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

如果您希望为自己的工具申请延期,请通过 https://services.google.com/fb/forms/apicontact/ 联系我们并获取申请表单。您的申请必须由贵公司的高管(首席执行管、首席技术官或高级副总裁)签字并提交。请注意,我们不保证您的申请一定会获得批准。

功能实现

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

为了满足最低功能要求,任何新增的必选功能必须在到期日(显示在每项功能旁边,格式为:到期日:YYYY-MM-DD)之前添加。若未指明到期日,则表明该最低功能要求的到期日已过。另外,如果您要对 AdWords API 客户端进行重大更改,我们要求您至少在更改生效之前两周,通过工具更改表单发送有关此次更改的屏幕截图和/或原型。也就是说,两周之后,您不需要等待 Google 的答复,更改即可自动生效。

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

创建功能

C.10 创建广告系列 Campaign 必选
C.14 设置移动设备的广告平台出价调整 出价系数 必选。需要同时在广告系列和广告组层级支持该功能。
C.15 设置平板电脑和桌面设备的广告平台出价调整 出价系数 必选。需要同时在广告系列和广告组层级支持该功能。
C.20 启用地理位置定位 地理位置定位 必选
C.21 设置距离定位 地理位置定位
LocationExtensionOperand
必选。需要支持定位到某地理位置周边一定半径范围内和附加地址信息。
C.25 设置地理位置出价调整 出价系数 必选
C.30 启用语言定位 定位类型 必选
C.41 动态搜索广告 DynamicSearchAd 必选
C.42 设置广告系列动态搜索广告设置 DynamicSearchAdsSetting 必选
C.50 选择加入/退出投放网络 NetworkSetting(仅限 targetGoogleSearchtargetSearchNetworktargetContentNetwork 必选
C.65 启用转化跟踪 ConversionTrackerService 必选
C.70 附加地址信息 Location Extensions 必选。需要在帐号层级支持该功能。
C.72 附加应用信息 应用 Feed 占位符
附加信息设置服务
Feed 服务
必选。需要在帐号层级支持该功能。
C.75 附加宣传信息 宣传信息 Feed 占位符
附加信息设置服务
Feed 服务
必选。需要同时在帐号、广告系列和广告组层级支持该功能。
C.80 v201609 附加链接 附加链接 Feed 占位符
附加信息设置服务
Feed 服务
必选。需要同时在帐号、广告系列和广告组层级支持该功能。
到期日:2017‑03‑31
C.90 设置出价选项:人工每次点击费用出价 ManualCpcBiddingScheme 必选。需要在广告系列层级支持该功能。
C.95 设置出价选项:智能点击付费 EnhancedCpcBiddingScheme 必选。需要在广告系列层级支持该功能。
C.101 设置出价选项:尽可能争取更多点击次数(组合) TargetSpendBiddingScheme 必选。需要在广告系列层级支持该功能。
C.111 设置出价选项:目标搜索页位置 PageOnePromotedBiddingScheme 必选。需要在广告系列层级支持该功能。
C.112 设置出价选项:排名胜出率目标出价策略 TargetOutrankShareBiddingScheme 必选。需要在广告系列层级支持该功能。
C.120 设置预算 广告系列预算 必选
C.140 设置投放方式 BudgetDeliveryMethod 必选
C.190 制作广告组 AdGroup 必选
C.191 设置广告组最高每次点击费用 CpcBid 每次点击费用人工出价选项和智能点击付费出价选项需要设置该功能。
到期日:2017‑12‑31
C.192 设置广告组目标每次转化费用 CpaBid 目标每次转化费用(“组合”和“标准”)出价选项需要设置该功能。
到期日:2017‑12‑31
C.193 设置广告组目标广告支出回报率 targetRoasOverride 标准目标广告支出回报率出价选项需要设置该功能。
到期日:2017‑12‑31
C.200 添加加大型文字广告 ExpandedTextAd 必选
C.260 添加关键字 Keyword 必选
C.270 添加广告组否定关键字 NegativeAdGroupCriterion 必选
C.290 设置关键字最高每次点击费用 CpcBid 必选
C.300 设置关键字匹配类型 matchType 必选
C.311 设置关键字最终到达网址 finalUrls 必选。
C.320 帐号一级的跟踪模板 trackingUrlTemplate 必选
C.321 广告系列一级的跟踪模板 trackingUrlTemplate 必选
C.325 广告系列一级的自定义参数 urlCustomParameters 必选
C.326 广告组一级的自定义参数 urlCustomParameters 必选
C.500 制作购物广告系列 购物广告系列 必选
C.505 设置商家标识符 ShoppingSetting 必选
C.506 设置销售国家/地区 ShoppingSetting 必选
C.510 设置库存过滤条件 ProductScope 必选
C.520 制作产品广告 ProductAd 必选
C.525 添加首个(根)产品划分 ProductPartition 必选
C.530 本地产品目录广告 ProductChannel
ProductChannelExclusivity
必选
C.610 来电专用广告 CallOnlyAd 必选
C.700 v201702 启用用户列表定位(将用户列表添加到搜索网络广告系列和广告组中,指定广告组排除对象和广告系列排除对象) 再营销和受众群体定位 必选。到期日:2017‑09‑01
C.710 v201702 为搜索网络广告系列和广告组设置用户列表定位出价调整 再营销和受众群体定位 必选。到期日:2017‑09‑01

管理功能

M.10 修改广告系列设置(创建功能中所有与广告系列相关的必选设置) Campaign 必选
M.15 修改移动设备、平板电脑和桌面设备的广告平台出价调整 出价系数 必选。需要同时在广告系列和广告组层级支持该功能。
M.20 修改广告组设置(创建功能中所有与广告组相关的必选设置) AdGroup 必选
M.25 修改地理位置出价调整 出价系数 必选
M.31 设置出价选项:目标每次转化费用(“组合”和“标准”) TargetCpaBiddingScheme 必选。“组合”和“标准”策略均需在广告系列层级支持该功能。
M.32 设置出价选项:目标广告支出回报率 TargetRoasBiddingScheme 必选。“组合”和“标准”策略均需在广告系列层级支持该功能。
到期日:2017‑12‑31
M.35 启用广告轮播 AdServingOptimizationStatus 必选
M.40 修改关键字最高每次点击费用 CpcBid 必选
M.100 修改加大型文字广告 ExpandedTextAd 必选
M.101 修改出价选项:尽可能争取更多点击次数(标准) TargetSpendBiddingScheme 必选。需要在广告系列层级支持该功能。
M.110 暂停/启用/移除广告系列 status 必选
M.120 暂停/启用/移除广告组 status 必选
M.130 暂停/启用/移除广告 status 必选
M.140 暂停/启用/移除关键字 userStatus 必选
M.150 修改库存过滤条件 ShoppingSetting 必选
M.160 细分(添加产品划分) ProductPartition 必选
M.170 移除产品划分 ProductPartition 必选
M.180 修改产品划分的最高每次点击费用 CpcBid 必选
M.190 排除产品划分(委托) NegativeAdGroupCriterion 必选
M.320 管理创建功能中的所有跟踪模板 Customer.trackingUrlTemplate
Campaign.trackingUrlTemplate
必选
M.325 管理创建功能中的所有自定义参数 Campaign.urlCustomParameters AdGroup.urlCustomParameters
必选
M.700 v201702 修改用户列表定位 再营销和受众群体定位 必选。到期日:2017‑09‑01
M.710 v201702 为搜索网络广告系列和广告组修改用户列表定位出价调整 再营销和受众群体定位 必选。到期日:2017‑09‑01

报告功能

R.10 帐号效果 点击次数
总费用
展示次数
转化次数1
所有转化次数
必选
R.20 广告系列效果 点击次数
总费用
展示次数
转化次数1
所有转化次数
广告网络
设备
必选
状态 如果要显示已暂停、有效以及已移除状态的广告系列,则为必选
如果只显示有效的广告系列,则为可选
R.30 广告组效果 点击次数
总费用
展示次数
平均排名
转化次数1
所有转化次数
广告网络
设备
必选
状态 如果要显示已暂停、有效以及已移除状态的广告组,则为必选
如果只显示有效的广告组,则为可选
R.40 广告效果 点击次数
总费用
展示次数
平均排名
转化次数1
必选
状态 如果要显示已暂停、有效以及已移除状态的广告,则为必选
如果只显示有效的广告,则为可选
R.50 关键字效果 点击次数
总费用
展示次数
平均排名
首页每次点击费用
页首每次点击费用
转化次数1
必选
状态 如果要显示已暂停、有效以及已移除状态的关键字,则为必选
如果只显示有效的关键字,则为可选
R.70 搜索查询效果 查询字词
匹配类型
点击次数
总费用
展示次数
必选
R.80 地理位置效果 国家/地区
区域
都市圈
城市
广告系列
点击次数
总费用
展示次数
必选
R.90 不含关键字的类别 点击次数 总费用
展示次数
转化次数1
必选
R.100 不含关键字的查询 点击次数
总费用
展示次数
必选
R.110 购物广告效果 点击次数
展示次数
总费用
转化次数1
必选
类别
产品种类
必选(以便显示所有层级)
R.120 产品划分 点击次数 总费用
展示次数
转化次数1
必选
R.130 出价目标效果 出价策略类型
点击次数
总费用
每次转化费用
展示次数
平均每次点击费用
转化次数
必选
状态 如果要显示已暂停、有效以及已移除状态的策略,则为必选
如果只显示有效的策略,则为可选
R.150 受众群体效果 点击次数
总费用
展示次数
转化次数1
必选

1. 201607 版中移除了 ConvertedClicks 字段及其衍生字段。请为所有报告使用 Conversions 列。

发送以下问题的反馈:

此网页
AdWords API
AdWords API
需要帮助?请访问我们的支持页面