Introducing Graph API v20.0 and Marketing API v20.0

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

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

常规更新

市场营销 API 版本自动升级

为提高市场营销 API 的流畅度和效率，增强此 API 的整体体验，我们很高兴宣布即将推出市场营销 API 版本自动升级功能。自今日起，我们将为在两个版本之间不受影响的市场营销 API 端点启用自动版本升级功能。这意味着，在要停用的版本与下一个可用版本之间，如果某个端点不受影响，该开放平台会自动升级调用，改为对下一个可用版本执行调用，而不是直接给出结果，表示请求失败。

如要详细了解相关行为，请参阅市场营销 API 版本管理和发布博客。

如要查看在各个版本中受影响的端点，请参阅更新日志。

如需更具体地了解 v20.0 的更新内容，请继续阅读。

通过市场营销 API 创建提醒广告

2024 年 5 月 13 日之前，开发者无法支持客户通过 Instagram 市场营销 API 创建 Instagram 提醒广告，客户只能通过 Meta 广告管理工具创建提醒广告。这种兼容性缺失的情况给我们的合作伙伴及其想要投放提醒广告的客户带来了不必要的麻烦。

在持续收到关于这种不兼容性的反馈后，我们现在将从 2024 年 5 月 13 日起支持通过 Instagram 市场营销 API 创建提醒广告。

我们感谢开发者社群及其客户提供的反馈意见，并希望继续改进通过市场营销 API 创建提醒广告的体验。

Instagram 提醒广告简介

Instagram 提醒广告通过鼓励感兴趣的用户设置提醒，帮助广告主顺利衔接商品推广与正式发布这两个环节。选择订阅的用户将在活动开始之前最关键的时刻收到提醒。

创建和编辑活动简介

Instagram 提醒广告根据活动开始时间和日期来确定何时发送提醒。这项更改使开发者可以利用 Instagram 图谱 API 创建和编辑活动。将活动附加到广告创意后，您可以通过 Instagram 市场营销 API 创建提醒广告。

广告账户节点的新增 API

全新广告账户节点更新不属于重大变更，只能算作 API 的一次功能扩展。调用此 API 后，将列出对应的广告账户下具有指导建议的所有广告系列，还将列出相应指南以及单次操作费用 (CPA) 的预期改进情况。

广告主将可利用这一全新 API 查看 Meta 对其广告系列的指导。合作伙伴中心已面向所有合作伙伴提供这些数据。不过，这些数据通过用户界面提供，您需要手动选择单个广告账户来查看指导信息。

我们希望通过 CPA_GUIDANCE API 自动获取这些数据，从而减少人工检查每个广告账户的指导信息的工作量。对我们的合作伙伴来说，使用此 API 可以在内部创建自定义视图并查看长期趋势。

如果您的企业管理着成百上千个账户，则很难逐一检查这些账户的任何指标，尤其是在指标具有时效性的情况下（RSS 建议每天更新，并且会考虑过去 28 天内的在投广告系列）。借助此 API，代理商可以识别出最有希望根据提供的建议进行优化的广告系列，随后将提供的建议整合到他们的系统中。

具体来说，代理商可以借助 CPA_GUIDANCE API 为其品牌合作伙伴提供指导，帮助他们了解哪些商品或类别的单次获取费用 (CPA) 最高。通过分享此信息，代理商可以帮助其品牌合作伙伴优化广告花费，同时改善他们的合作广告系列的整体表现。

代理商还可以通过观察 CPA 的改善趋势来追踪指导建议是否得到执行。

多广告主广告

从今天起，我们将支持广告主通过市场营销 API 选择启用多广告主广告。在这项更新之前，开发者无法支持客户通过 API 创建多广告主广告，客户只能通过 Meta 广告管理工具选择启用多广告主广告。

多广告主广告简介

多广告主广告有助于用户发现多个商家的商品和服务。针对 Facebook 和 Instagram 上的部分版位，此广告可与同一广告单元中的其他广告一同展示，以帮助用户发现符合其个性化需求的商家的商品和服务。广告单元是一个容器，其中包含通常在同一页面上展示的多条广告。前往 Business 帮助中心了解详情。

对开发者有何影响

市场营销 API 发布时，通过此 API 创建的多广告主广告的投放功能默认处于关闭状态，这意味着开发者需要为客户的广告实施代码更改，这些广告才会有资格在相关体验中投放。所有市场营销 API 版本均支持创建多广告主广告。但是，所有符合多广告主广告使用条件的广告创建请求均必须指定广告是否启用该功能。2024 年 8 月 19 日，多广告主广告将更改为默认开启状态，尚未实施代码更改的开发者将需要实施代码更改，以便为其客户提供禁用相关体验的功能。

市场营销 API 即将推出生成式 AI 创意功能：文案生成、扩图和背景生成

2023 年 10 月，我们宣布在广告管理工具中面向广大商家推出首款由生成式 AI 提供技术支持的创意广告功能，即文案生成、扩图和背景生成。今天，我们想要告知大家，市场营销 API (MAPI) 将为广告主提供这些生成式 AI 创意功能，这样一来，合作伙伴、代理商和广告主也可通过市场营销 API 来充分利用 Meta 生成式 AI 产品。

使用这些功能可以快速且自动生成多个创意版本，开启创意新时代，助力所有广告主最大程度提升广告投放效率、广告定制化程度以及广告表现：

• 背景生成功能：创建最多四个背景以补充商品图片，为受众提供多元化的创意。生成的背景将基于您的原始商品图片，通常是带有颜色和图案的简单背景。

• 扩图功能：巧妙地调整图片创意素材，使其适应多种界面（先从动态开始，不久后将推广到 Reels）的不同宽高比，减少您为创意素材再加工而投入的时间和资源。

• 文案生成功能：根据您的原始文案生成多个版本的广告文案，突出商品/服务的卖点，并生成多个文案选项，为受众打造多元化的广告。

今天，我们将面向更多广告主推出这些功能，我们很高兴能够让更广大的受众体验到生成式 AI 的强大威力。

根据我们对可能受到额外审查的新产品进行测试的方法，某些行业领域（例如金融服务和制药/保健）以及住房、就业或金融服务/信贷类 (HEC) 广告，社会议题、选举或政治类 (SIEP) 广告可能无法立即访问所有生成式 AI 功能。

运作方式

今天，我们即将推出对这些功能的支持，这些功能属于市场营销 API（更具体地说，是广告创意 API）的一部分。广告主将可选择使用 API 中的这些功能以及预览 API 中的生成式 AI 创意。

以下示例展示了如何为您的广告创意启用市场营销 API 中的生成式 AI 功能。

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

注意：以上示例展示了如何启用背景生成功能。同样，对于“扩图”功能，请使用 image_uncrop 密钥；对于“文案生成”功能，请使用 creative_features_spec 中的 text_generation 密钥。

广告主还可以通过 API 预览由生成式 AI 转化而成的创意。请点击开发者文档链接，详细了解如何生成和提供广告创意，以及如何预览生成式 AI 各项功能生成的内容。

Instagram 视频 API：Instagram 视频 API 断点续传

全新的“断点续传协议”于 2024 年 5 月 15 日开始实施，该协议支持通过本地视频和公开托管的网址视频发布 Instagram 视频（例如，Reels、视频快拍和视频轮播体验）。这项新协议支持本地文件上传、长视频上传（ 仅适用于 Reels ，即最长 15 分钟），以及在网络中断或发生其他传输故障后恢复上传操作。

以前，要创建 Instagram 视频，必须将视频文件上传到可公开访问的托管服务，在此获取可共享的网址并将其提供给 Meta 才能发布视频。

改进后的内容发布流程详情可在内容发布开发者文档中找到，在此文档中还可找到有关 Instagram 素材的更多详情。

Instagram 图谱 API：启用新指标

从今天开始，图谱 API 将新增六个“轮播容器素材”指标。这些指标包括“获赞数”、“评论数量”、“分享次数”、“关注人数”、“主页动态”（即用户访问您的主页时采取的操作次数）、“主页访问量”（即您的主页被访问的次数）。这些指标已在 Instagram 的成效分析页面中提供，但这次更新将确保也可以通过图谱 API 获取相应数据。

在轮播帖的图谱 API 端点中添加“获赞数”、“评论数量”、“分享次数”、“关注人数”、“主页动态”、“主页访问量”后，您即可直接通过 API 调用读取这些指标。

立即点击此处参考这些指标的完整列表，以便将相关指标添加到轮播容器的 GET API 调用。

新版停用时间表：Meta 线下转化 API (OCAPI)

去年，我们宣布线下转化 API 版本 17 将不再支持线下事件，并预计线下转化 API 将于 2024 年第 3 季度停用。此后，我们更新了这一预期停用时间表，并确认线下转化 API (OCAPI) 将于 2025 年 5 月停用。虽然 OCAPI 的停用时间从 2024 年第 3 季度延长至 2025 年 5 月，但我们仍然鼓励目前正在通过线下转化 API (OCAPI) 发送线下事件的广告主继续计划迁移其现有设置，以便开始通过转化 API（适用于线下的转化 API）发送线下事件。

停用及重大变更

停用 Messenger API 中的预约按钮

即日起，Messenger API 调用将不再支持“预约”按钮。此更改不会影响其他模板和按钮，企业仍可使用 Meta Business Suite 管理预约。

市场营销 API 中不再支持创建“赞助消息”广告类型

从今天起，市场营销 API v20.0 将不再支持创建“赞助消息”广告类型，并且 90 天后之前版本的 API 也将停止支持创建此广告类型的广告。此更改不会影响其他消息广告类型。

我们建议检查当前集成并根据需要调整应用程序，确保用户实现顺利过渡。

移除成效分析人口统计数据指标的非关键时间范围（通过外部 Instagram 图谱 API）

2024 年 5 月 21 日，我们推出了第 20 版的 Instagram 图谱 API。

推出 90 天后（即 2024 年 8 月 19 日），图谱 API 将不再共享在 Instagram 图谱 API 的非关键时间范围内参与互动和触达的受众成员的人口统计数据指标（例如，过去 14 天和 90 天的国家/地区、城市、年龄和性别分布信息）。

Instagram 图谱 API 仍将返回过去一个月（即“this_month”）和过去一周（即“this_week”）的人口统计数据信息（类似于 Instagram 应用），以确保各个平台间的一致性。

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

如需详细了解，请参阅开发者文档。

API 版本停用信息：

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

图谱 API

• 2024 年 5 月 28 日：图谱 API v13.0 将被停用并从平台中移除。

• 2024 年 9 月 17 日：图谱 API v14.0 将被停用并从平台中移除。

• 2024 年 11 月 20 日：图谱 API v15.0 将被停用并从平台中移除。

市场营销 API

• 2024 年 8 月 13 日：市场营销 API v18.0 将被停用并从平台中移除。

• 2025 年 2 月 4 日：市场营销 API v19.0 将被停用并从平台中移除。

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

Meta Business SDK

Meta Business SDK v20 版本

Meta Business SDK v20 版本将在图谱 API v20 发布后不久发布。该版本将包括漏洞修复、依赖项升级和新功能，最重要的是将更新 API 接口以与图谱 API v20 保持一致。

在此版本中，我们还将推出针对 Instagram API 的额外支持。其中包括 IGMediaForIGOnlyAPI、IGUserForIGOnlyAPI、IGRefreshAccessTokenForIGOnlyAPI 和 IGAccessTokenForIGOnlyAPI。借助这些支持，您可以在现有 Instagram API 的基础上有更多其他方法来直接获取素材。我们的目标是启用更多涵盖其他 Meta 产品的 API，以丰富业务 SDK 的生态系统。

根据平台 SDK 的两年停用计划，近期的停用和结束运行信息如下，敬请关注：

• 2024 年 5 月：Facebook 开放平台 SDK v13.0 或更低版本将停用。