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

2023年9月12日发布者：Naveen Santhanavel

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

如需获取所有变更的完整列表及变更详情，请访问我们的更新日志。

常规更新

整合地区定位的受众所在地区状态选项

正如之前 2023 年 5 月所宣布，我们已将在地区定位选项中选择要触达的受众类型时的受众所在地区状态合并为当前的“居住在或最近位于该地区的用户”默认选项。此更新反映了对其他之前可用选项的整合，并移除了“到该地区旅游的用户”选项。

推出此变更是我们不断改进的举措之一，旨在为企业提供更多价值、简化我们的广告系统、精简我们的定位选项，以求提高营销效率和移除使用率低的选项。

此更新将适用于新建或复制的广告系列。更新发布前创建的现有广告系列不会适用此新体验，除非它们处于草稿模式或是复制版本。

将“add_security_recommendation”和“code_expiration_months”添加到 WA 消息模板 API

今年早些时候，我们发布了 WhatsApp 身份验证解决方案，该解决方案支持创建和发送包含原生按钮和预设身份验证消息的身份验证模板。随着图谱 API v18 的发布，我们将改进身份验证模板的检索，使 BSP（商务解决方案提供商）和企业能更轻松地完成端到端身份验证模板流程。

借助图谱 API v18，BSP 和企业可以在完成创建后更好地了解预设身份验证消息模板内容。具体而言，除 WhatsApp 使用的文本之外，有效负载还将返回预设内容配置选项。此改进使 BSP 和企业能够为可基于 API 构建的身份验证模板创建“编辑”用户界面。

请注意，在升级到图谱 API v18 时，如果 BSP 或企业从 GET 请求获取整个响应并将其传回 POST 请求以更新模板，则可能会出现错误。要解决此问题，应在传回至 API 前移除正文/标头/页脚文本字段。

重新发布用于创建来电专用广告的开发者文档和更新日志

来电专用广告的 Facebook Reels 版位
Meta 将推出通过 Facebook Reels 平台投放来电专用广告 (Call Ad) 的功能。来电专用广告支持处于品牌考量阶段的查看广告的用户致电企业咨询，及帮助企业与意向客户展开更深入的交流。对企业而言，这是根据用户在 Facebook 上的实时行为投放来电专用广告开展营销的良机。在广告管理工具中的“广告组”层级下，企业可以选择在“版位”版块下添加“Facebook Reels”。
重新启动通过 API 创建来电专用广告
2023 年 9 月 12 日，我们将发布有关如何通过 API 创建来电专用广告的更新指南。我们将推出专门针对来电专用广告的文档，以便第三方开发者能够更轻松地创建来电专用广告系列，并了解如何查看在投来电专用广告系列的相关成效分析（包括通话相关指标）。今后，我们还计划通过我们的 API 平台为通话附加组件提供支持。开发者应具备创建常规广告所需的一般权限，以便通过 API 平台创建来电专用广告。

请参阅开发者文档获取更多信息。

停用及重大变更

用户细化权限功能的图谱 API 变更

我们将针对 WhatsAppBusinessAccount 更新两个图谱 API 端点。相关端点如下：

检索与 WhatsApp Business 业务帐户关联的消息模板
检索与 WhatsApp Business 业务帐户关联的电话号码

在 v18 中，我们将推出一项新功能——“用户细化权限”。已添加至 WhatsAppBusinessAccount 的所有现有用户将进行数据回填并将继续拥有权限（无影响）。

管理员可灵活更改这些权限。如果管理员更改权限并针对某用户移除查看消息模板或电话号码权限，相应用户将收到错误消息，表明其无权在所有 v18 版本及更早版本中查看消息模板或电话号码。

停用 Instagram 媒体内容和用户成效分析的旧版指标命名

自 9 月 12 日起，Instagram 将从 Instagram 图谱 API 中移除重复和旧版成效分析指标，以便向我们的开发人员提供一个统一的指标来源。

这一全新升级消除了混淆，并提高了我们报告的可靠性和质量。

推出此更新 90 天后（即 2023 年 12 月 11 日），我们将从所有版本的 Instagram 图谱 API 中移除所有重复和旧版成效分析指标，以尽量与 Instagram 应用保持一致。

我们感谢开发者社群提供的所有反馈，并期待能继续保持合作。

请参阅媒体内容成效分析和用户成效分析开发者文档以了解更多信息。

停用所有 Facebook Wi-Fi v1 和 Facebook Wi-Fi v2 端点

Facebook Wi-Fi 旨在改善企业 Wi-Fi 热点的连接体验。借助此产品，商家的客户只需在 Facebook 上签到即可使用免费 Wi-Fi。它还支持商家控制 Wi-Fi 的可用对象及使用时长，还可搭配广告使用以定位使用过商家 Wi-Fi 的客户。该产品已于 2023 年 6 月 12 日停用。随着合作伙伴通知期的结束，Facebook Wi-Fi v1 和 Facebook Wi-Fi v2 使用的所有端点均已停用并移除。