隆重推出 Facebook 图谱 API v19.0 和市场营销 API v19.0

2024年1月23日发布者：Mohamed Amr Abouelhassan

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

如需查看所有变更的完整清单及有关详情，请访问我们的更新日志。

常规更新

面向所有广告目标和优化启用赋能型细分定位

我们始终致力于协助广告主提升广告表现，为此，我们现在将面向所有广告目标和优化开放赋能型细分定位产品的使用。

赋能型细分定位功能属于赋能型产品套件的一部分，可利用高级自动化和机器学习技术助力提升广告主的营销表现。具体来说，使用赋能型细分定位时，如果经系统预测有望改善营销表现，则会支持系统触达比广告主最初的细分定位选择中定义的受众更宽泛的用户群，从而助力提高营销表现。

2024 年 1 月 23 日，我们将面向使用市场营销 API 的广告主和合作伙伴推出以下变更：

针对“展示次数”、“视频观看量”、“覆盖人数”、“互动”或“广告回想度提升”进行优化的广告系列现在将可以选择启用赋能型细分定位。
针对“潜在客户”进行优化的广告系列将自动应用赋能型细分定位，并提供禁用选项。
- 请注意：针对新建和复制的广告系列/广告组，启用选项将处于打开状态。如有需要，可以将此选项关闭。
针对“链接点击量”或“落地页浏览量”进行优化的广告系列将自动应用赋能型细分定位，且不会提供禁用选项。

对于使用市场营销 API 的广告主和合作伙伴而言，这些变更将带来重大变化。从 2024 年 1 月 23 日起，开发者可以开始实施代码变更，且必须在 2024 年 4 月 22 日之前完成更新。这一变更将在新的 API 版本 V19 中发布。

<Impacted endpoints>

请求类型	端点	变更
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	针对“链接点击量”或“落地页浏览量”进行优化的广告系列将不接受“targeting_optimization”栏位。这也适用于赋能型细分定位中包含的之前的优化（不提供禁用选项），包括“转化量”、“价值”、“应用安装量”、“应用事件数量”和“对话次数”。对于针对“展示次数”、“视频观看量”、“覆盖人数”、“互动”、“广告回想度提升”或“潜在客户”进行优化的广告系列，targeting_as_signal 栏位应该为空或 0，否则将抛出错误。
POST	/act_{ad_account_id}/{adsets} /{adset-id}	针对“链接点击量”或“落地页浏览量”进行优化的广告系列将不接受“targeting_optimization”栏位。这也适用于赋能型细分定位中包含的之前的优化（不提供禁用选项），包括“转化量”、“价值”、“应用安装量”、“应用事件数量”和“对话次数”。对于已启用赋能型细分定位且未提供禁用选项的所有优化，我们将根据目标 + 优化的组合自动将 targeting_as_signal 栏位设置为 1 或 3。

请求类型

端点

变更

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

针对“链接点击量”或“落地页浏览量”进行优化的广告系列将不接受“targeting_optimization”栏位。这也适用于赋能型细分定位中包含的之前的优化（不提供禁用选项），包括“转化量”、“价值”、“应用安装量”、“应用事件数量”和“对话次数”。
对于针对“展示次数”、“视频观看量”、“覆盖人数”、“互动”、“广告回想度提升”或“潜在客户”进行优化的广告系列，targeting_as_signal 栏位应该为空或 0，否则将抛出错误。

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

针对“链接点击量”或“落地页浏览量”进行优化的广告系列将不接受“targeting_optimization”栏位。这也适用于赋能型细分定位中包含的之前的优化（不提供禁用选项），包括“转化量”、“价值”、“应用安装量”、“应用事件数量”和“对话次数”。
对于已启用赋能型细分定位且未提供禁用选项的所有优化，我们将根据目标 + 优化的组合自动将 targeting_as_signal 栏位设置为 1 或 3。

市场营销 API - 新建使用原始目标的广告、广告组和广告系列

从市场营销 API v19.0 起，无法再通过广告文案新建使用原始目标（如下所示）的广告、广告组和广告系列。需要对广告目标进行更新，以便显示简化版目标。

从市场营销 API 版本 20 起，将不再支持在使用原始目标创建的广告系列下创建广告和广告组。但是，低于 v20 的所有 API 版本（即 v19、v18）仍将支持此功能。对于使用原始目标的现有广告，无需立即采取操作。

受影响的原始目标

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

受影响的 POST 端点

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

点击此处可查看之前的开发者博文，内容涉及使用原始目标创建广告系列的 API 变更，供您参考。

常见问题

问：此变更是否需要更新代码？

答：需要，V18 有多个 API 调用无法用于 V19（即无法通过广告文案新建使用原始目标的广告、广告组和广告系列）。

问：变更前后的预期行为是什么？

答：变更之前，复制使用原始目标的广告、广告组或广告系列的 API 调用将成功，而现在将失败。

问：实施代码变更的时间安排是怎样的？

答：直到 v18.0 停用为止，暂定于 2024 年 9 月。

其他开发者文档

帮助文章

PPCA（公共主页公开内容访问权限）

使用 PPCA（公共主页公开内容访问权限）收集的数据的用例已更改。如需了解详细信息，请点击以下链接查看。

隆重推出进阶赋能型受众 API

去年 10 月，我们推出了进阶赋能型受众，这是一种全新的简化版受众创建体验，可在锁定广告主最想触达的目标用户群的同时拓宽广告投放的潜在受众范围，从而助力提升营销表现。

现在，我们将在市场营销 API 中发布进阶赋能型受众。

要启用此功能，请将 advantage_audience 中的 targeting_automation 参数设置为 1。
要禁用此功能，请将 advantage_audience 中的 targeting_automation 参数设置为 0。

停用及重大变更

停用 Facebook 小组 API

Facebook 小组 API 将在 v19 中停用，并在 90 天后从所有版本中移除。本次停用包括与 Facebook 小组 API 相关的所有权限（publish_to_groups、groups_access_member_info）和可审核功能（小组 API）。

小组 API 的主要用例为小组中的私密回复。我们将在 v19 中推出另一项变更，这将让开发者无需借助小组 API 即可使用该用例。对于大多数私密回复开发者来说，v19 中将不会进行任何变更。对于在收到私密回复 webhook 后依赖于通过小组 API 调用小组帖子端点的开发者来说，他们现在需要确保为这些请求使用公共主页访问口令。

开发者若不确定其端点是否使用已停用的权限，则可通过在 19.0 版本中测试端点来进行验证

公共主页成效分析 API 变更 - 指标停用

随着我们从 Facebook 经典版公共主页体验迁移至新版公共主页体验，我们将停用大量公共主页成效分析 API 指标。如需了解详细信息，请点击此链接查看。

API 版本停用信息：

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

图谱 API

2024 年 2 月 8 日：图谱 API v12.0 将停用，并从平台移除
2024 年 5 月 28 日：图谱 API v13.0 将停用，并从平台移除
2024 年 9 月 17 日：图谱 API v14.0 将停用，并从平台移除

市场营销 API

2024 年 2 月 6 日：市场营销 API v16.0 将停用，并从平台移除
2024 年 5 月 14 日：市场营销 API v17.0 将停用，并从平台移除

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

Meta Business SDK

Meta Business SDK v19 版本

Meta Business SDK v19 版本将在图谱 API v19 发布后不久发布。该版本将包括漏洞修复、依赖项升级和新功能，最重要的是将更新 API 接口以与图谱 API v19 保持一致。今后，我们计划更频繁地发布 SDK，以配合 API 的更新节奏。这将使开发者能够及时了解最新的 API、功能和特性。

作为我们平台 SDK 两年停用计划的一部分，请留意近期的停用和结束运行信息：