Facebook 图谱 API v15.0 和市场营销 API v15.0 简介

今天，我们隆重推出 Facebook 图谱 API v15.0 和市场营销 API v15.0。作为此次版本发布的一部分，我们在下方重点列出了我们认为对部分开发者社群至关重要的变更。这些变更包括公告、产品更新和停用通知，我们认为这些变更与您的应用程序与我们平台之间的集成息息相关。

有关所有更改及详情的完整清单，请访问我们的更新日志。

一般公告及更新

简化自定义转化事件创建条件

要为广告主简化广告系列创建流程，新创建的自定义转化事件将至少需要遵循一条与图谱 API v15.0 版本相关的规则。如果自定义转化事件未遵循规则，则应利用自定义事件优化功能，实现直接在自定义事件上优化广告系列。我们正在积极努力，将现有自定义转化事件从单一的一体式产品转变为多种具有特定价值的产品，更好地满足广告主的需求和用例。这一更改将推动广告主从使用基于自定义事件的自定义转化事件转为使用自定义事件优化。

开放平台条款更新

我们将更新开放平台条款，在此次修订中，对于应用在一段时间内未使用或访问的任何开放平台 API、权限或功能，我们将调整移除应用相应使用权限的时机。更新版开放平台条款将于 2022 年 12 月 15 日生效，根据本条款，28 天内有活动的应用才会被视为活跃应用。

如果您收到通知称您的应用处于不活跃状态，而您希望恢复其状态，则可通过应用管理员身份将其恢复为活跃状态。

点击此处可阅读开放平台条款，预先了解这些更改的完整信息。

停用及重大变更

赋能型自定义受众正式上线

从 2022 年 9 月 19 日开始，我们将推出赋能型自定义受众。赋能型自定义受众利用广告主的自定义受众来引导广告投放，可帮助找到更多所需受众，使广告主可能达到其宣称的优化目标。这意味着，如果有可能提高广告效果，我们投放广告的受众范围将超出广告主的自定义受众范围。赋能型自定义受众是我们赋能型定位产品套件的一部分，包括赋能型细分定位和赋能型类似受众。我们的赋能型定位产品利用先进的自动化和机器学习技术，以更少的人力帮助广告主提高广告系列的效果。

利用自定义受众的广告主将可以选择赋能型自定义受众。借助赋能型自定义受众，广告主将可以继续创建自定义受众（网站、应用事件、客户名单或互动），并应用相关的包含条件或排除条件；同时，我们先进的自动化和机器学习技术可以将您的自定义受众作为指导广告投放的来源，使您得以覆盖更多用户，从而有可能实现自己宣称的优化目标。

当您创建包含网站、移动端或互动自定义受众的新广告系列时，系统将自动启用赋能型自定义受众。您可以前往我们广告创建工具里的“自定义受众”部分，取消勾选其中的“赋能型自定义受众”复选框，选择停用该产品。

特殊广告受众停用信息

根据我们与美国住房和城市发展部 (HUD) 所达成的协议，我们将停用特殊广告受众，该工具可以让广告主扩大住房、招聘和信贷相关广告组的受众范围。我们将从 2022 年 9 月 15 日开始，停用通过市场营销 API 创建特殊广告受众的功能。

对于广告主和合作伙伴来说，于 2022 年 9 月 15 日禁用特别广告受众新建工具将带来一个重大变更，因为在这个非版本化的变更中，之前的值已停用。2019 年，除了取消针对住房、招聘和信贷广告的某些定位选项外，我们还推出了“特殊广告受众”来取代“类似受众”。但是，机器学习公平性领域是一个动态的、不断发展的领域，特殊广告受众工具是早期的问题解决方案。现在，我们将重点关注能够提高公平性的新方法，包括此前已经公布的方法。

此次停用所涉及的受影响端点列表，请参见下文：

读取受众：

• endpoint gr:get:AdAccount/customaudiences
• field operation_status

广告组创建：

• endpoint gr:post:AdAccount/adsets
• field subtype

广告组编辑：

• endpoint gr:post:AdCampaign
• field subtype

自定义受众创建：

• endpoint gr:post:AdAccount/customaudiences
• field subtype

自定义受众编辑：

• endpoint gr:post:CustomAudience

有关支持代码实现的更多详情，请参阅往期博文和开发者文档。

对赋能型细分定位/赋能型类似受众一视同仁

对于使用以消息/应用安装为目标（广告管理工具发布后）的广告组的 API 用户，本项目对其用作信号的细分定位（赋能型细分定位）一视同仁。我们之前针对以转化事件为目标、以转化事件/价值为优化目标的广告组（VO/OC 广告组）推出了 API 专用赋能型细分定位。

目前，当广告主通过 API 创建以消息或应用安装为目标的广告组时，他们会在定位条件 (L2) 中传递两项内容。他们会传递一个细分定位输入（如板球、足球、狗等）和一个标记，表明他们是否想扩展这些输入内容（称为赋能型细分定位）。如果启用该标记，我们的系统就会在有可能提高广告效果的情况下，投放超出其细分定位选择范围的内容。如果禁用该标记，我们的系统将仅投放广告主所提供的选择项列表。

未来（广告管理工具发布后），当广告主创建以消息或移动应用安装为目标的新广告系列时，其细分定位包含条件将仅用作指导广告投放的一个输入项（而非设限项）。因此，我们将停用这些目标的 DTE 标记，并使定位扩展成为细分定位选择范围的一个默认行为。在此期间，我们可以在有可能提高广告效果的情况下，针对细分定位包含条件范围外的项目投放内容。所有其他定位选择和排除条件将不受影响。此更改不适用于特殊类别。

运作方式：

在过去，广告主会传递 targeting_optimization 标记，该标记的值可为 expansion_all 或 none，分别表示启用或禁用细分定位扩展。鉴于这些广告组的细分定位操作方式在语义上的更改，广告主在创建以消息或应用安装为目标的广告组时，无需传递该标记，因为它不会对他们新创建的广告组产生影响。所有这些新创建的广告组将始终使用细分定位包含条件作为传递给我们后端系统的信号。后端系统可能会决定向这些选择范围之外的受众投放广告，前提是这种投放可为广告主实现更佳的广告效果。

鉴于 targeting_optimization 标记不会对新创建的广告组产生任何影响，我们计划未来在以消息和/或应用安装为目标的新广告系列中停用该字段。

• 因此，如果广告主在创建新 MAI/消息广告组时或在查询这些新创建广告组的投放预估时传递了 targeting_optimization 标记，我们将抛出一个错误消息，要求他们不再发送此参数。
• 在创建新应用安装/消息广告组期间，后端将设置一个名为 targeting_as_signal 的新字段。该字段可见于 GET 命令，仅用于帮助广告主验证他们的广告组是否超出了细分定位包含条件。

注意：对细分定位信号做出的这些更改仅适用于以消息和/或应用安装为目标的新创建广告组。

范围内的 API 端点：

• gr:post:/act_XXXX/ adsets
• gr:get:/<adset_id>/delivery_estimate

公共主页选项卡停用信息

我们宣布，公共主页自定义选项卡 API 功能将不再通过图谱 API 提供。由于我们推出新公共主页体验，一些公共主页 API 功能将随着我们的发展而停用。新公共主页体验上将不再提供公共主页自定义选项卡功能，因此我们将停用对这些功能的 API 支持。现在我们分享这些更新，是为了让开发者及其客户有足够的时间通过他们的公共主页传达功能停用事宜，并对他们的公共主页做出必要的更改。该功能将于 2022 年 12 月 14 日完全停用。

API 版本停用信息：

作为 Facebook 图谱 API 和市场营销 API 版本控制计划的一部分，请注意近期的停用信息：

图谱 API

• 2022 年 11 月 1 日：将停用图谱 API v8.0，并从开放平台移除
• 2023 年 2 月 23 日：将停用图谱 API v9.0，并从开放平台移除
• 2023 年 6 月 8 日：将停用图谱 API v10.0，并从开放平台移除

为避免您的业务出现中断，我们建议您立即将所有调用迁移到今天发布的最新版 API 中。

Facebook 开放平台 SDK

作为我们开放平台 SDK 两年停用计划的一部分，请留意近期的停用和废弃信息：

• 2023 年 1 月，Facebook 开放平台 SDK v8.0 或以下版本将废弃
• 2023 年 6 月，Facebook 开放平台 SDK v9.0 或以下版本将废弃
• 2023 年 10 月，Facebook 开放平台 SDK v11.0 或以下版本将废弃