Introducing Graph API v22.0 and Marketing API v22.0

发布者 Ayyad Farah

今天，我们隆重推出图谱 API v22.0 和市场营销 API v22.0。在此次版本发布中，我们重点梳理了以下变更内容，相信会对部分开发者社群有所助益。这些变更包括公告、产品更新和停用通知，这些变更与您的应用程序和我们平台之间的集成息息相关。

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

常规更新

市场营销 API v22 对在住房、就业及金融产品和服务（包括信贷）类广告系列中使用客户名单自定义受众的变更

适用于“v22.0+”版本，并将于 2025 年 3 月推广到所有版本

某些客户名单自定义受众将不符合在住房、就业及金融产品和服务（包括信贷）类广告系列中使用的条件。点击此处，详细了解此项更新，查看这些限制是否适用于您。此外，is_sac_cfca_terms_certified 栏将添加到广告组层级，请查看示例。您需要使用此栏来认证住房、就业及金融产品和服务（包括信贷）类广告系列的广告组中使用的任何客户名单自定义受众均符合 Meta CLCA 认证的规定。从 2025 年 4 月初开始，使用不符合要求的客户名单自定义受众的现有广告系列/广告组可能会被叫停。若发生这种情况，您会在广告管理工具和市场营销 API 中看到错误和相关说明。

以下端点将受到影响：

自定义受众 API v22

自 2025 年 1 月 6 日起，您可以使用新的 is_eligible_for_sac_campaigns 栏来标识是否可以在特殊广告类别广告系列的广告组中使用自定义受众。您必须为将要使用受众的特殊广告类别广告系列提供预定 special_ad_categories 和 special_ad_category_countries，并提供使用受众来创建或编辑广告组的 ad_account_id。

以下端点将受到影响：

GET /custom_audience_id

覆盖对选定城市和地区感兴趣的用户

我们很高兴地宣布推出一项新的地区定位功能，此功能可帮助广告主将投放范围扩大到目标城市或地区以外，从而提升广告表现，助力我们的广告系统灵活地面向对某个地区感兴趣的人群投放广告。

此功能扩展了现有的地区定位功能，使您能够覆盖对同一国家/地区您所定位的城市和地区具有旅游意向、购买意向或一般兴趣的用户。

在测试过程中，使用新版地区定位功能的客户将单次成效费用降低 6.7%。

如需详细了解，请点击此处。

停用及重大变更

“IG 用户”、“IG 素材”和“IG 评论端点”将取代“Instagram 用户”、“Instagram 素材”、“Instagram 轮播”和“Instagram 评论端点”

我们正在对 Instagram 图谱 API 和市场营销 API 进行更改，以便开发者更轻松地为企业打造解决方案。变更后，我们将弃用图谱 API v22 中的“Instagram 用户”、“Instagram 素材”、“Instagram 轮播”和“Instagram 评论”对象，改用现有的 IG 用户、包含轮播的 IG 素材和 IG 评论对象。我们还为这些较新的对象增加了功能，以满足大多数用例的需求。

开发者必须在 2026 年 1 月 21 日之前更新所使用的受影响市场营销 API 端点，并在 2025 年 4 月 21 日之前更新使用的受影响图谱 API 端点。如果您在 API 调用中自动更新图谱 API 版本，建议您查看这些更改，因为它们对使用图谱 API v22 的开发者即时生效。

请参阅开发者博客了解此项变更的更多详情，包括哪些端点发生变化、哪些用例不再受支持以及具体的时间表。

移除细分定位排除条件

为持续助力广告主提升表现，我们将移除细分定位排除条件。在此过程中，我们仍会支持您在账户层级的受众控制选项中排除雇主受众。如需获取账户控制选项的更多信息，请点击此处。

我们相信这项变更将有助于提高广告系列的表现。一项广告主测试显示，相比使用细分定位排除条件，不使用细分定位排除条件使单次转化费用中值降低了 22.6%。

由于此项变更，排除条件栏将不再支持自定义受众。您仍可通过使用 excluded_custom_audiences 栏来继续使用自定义受众排除条件。

自 2025 年 1 月 21 日起，开发者可以开始实施代码变更，且必须在 2025 年 4 月 21 日之前完成这些更新。这项变更将在 v22 中发布。请参阅开发者博客，获取与此项变更相关的受影响端点列表。

停用市场营销 API 中的标准美化捆绑包

市场营销 API v22.0 对进阶赋能型素材美化的影响

在这个新版市场营销 API 中，我们将不再使用进阶赋能型素材标准美化捆绑包，而是改用单独的素材美化启用选项。您可以点击此处详细了解进阶赋能型素材。

您可以点击此处详细了解与开发者社群相关的信息，更多详情请点击此处查看我们的开发者文档。

以下这些端点将不再支持标准美化功能：

POST /{ad_account_id}/adcreatives
POST /{ad_account_id}/ads
GET /{ad_id}/previews

隆重推出“Instagram 浏览量”指标并停用“展示次数”和“播放量”指标

为了持续让 Instagram API 的功能与 Instagram 应用的功能保持一致，我们将在所有 API 版本中针对影音内容和用户成效分析推出 “浏览量” 指标。对于影音内容成效分析，“动态”、“快拍”和“Reels”对象将返回浏览量。对于用户成效分析，API 将支持“浏览量”指标，并根据粉丝类型和影音内容产品类型提供多维度细分数据。

此外，自 v22 版本起，以下指标将停用：

plays（影音内容成效分析）：Reels 在系统统计展示次数后开始播放的次数。
clips_replays_count（影音内容成效分析）：Reels 首次播放后再次开始播放的次数。定义为在同一 Reels 会话中重播至少 1 毫秒的次数。
ig_reels_aggregated_all_plays_count（影音内容成效分析）：Reels 在系统统计展示次数后开始播放或重播的次数。
impressions（影音内容和用户成效分析）：Instagram 影音内容对象的总观看次数。

仅针对在 2024 年 7 月 2 日当天或之后创建的影音内容停用影音内容成效分析“展示次数”指标。对于在此日期之前创建的影音内容，API 将一如既往地返回所有版本的值。

如需更多信息，请参阅我们的 Instagram 用户成效分析和 Instagram 影音内容成效分析的开发者文档。请建议开发者在 2025 年 4 月 21 日前进行更新，以免出现问题。