2025 年不定期更改 2025 年市场营销 API 的不定期更改。

2025年10月29日

成效分析 自 2025 年 10 月 29 日起适用于所有版本。 正式推出“instagram_profile_visits”成效分析指标,该指标衡量用户因与广告互动而对广告主的 Instagram 主页产生的访问次数。这包括点击广告的行动号召按钮、头像或账号直接前往 Instagram 主页的次数。以下端点会受到影响:* GET /{campaign-id}/insights * GET /{ad-set-id}/insights * GET /{ad-id}/insights

2025年10月28日

Threads 广告

  • Advantage+ catalog ads are now available for Threads ads. Only images and image carousels are currently supported. Slideshow, video and entry cards are not supported at this time. See Threads Advantage+ Catalog Ads for more information.

2025年10月13日

广告成效分析 API 近期变更 自 2026 年 1 月 12 日起适用于所有版本。 * 统计时间窗:7 天浏览(action_attribution_windows=7d_view)和 28 天浏览(action_attribution_windows=28d_view)统计时间窗的数据将不再可用,并且将不返回任何数据 * 历史数据:某些字段和细分数据的历史数据保留期有限,如果查询的 start_date 超出其保留期限,则不会返回任何数据:* 仅限 13 个月:独立计数字段(如 unique_actionscost_per_unique_action_type)的所有细分数据;以及所有字段(即 breakdowns=hourly_stats_aggregated_by_advertiser_time_zone)的每小时细分数据 * 仅限 6 个月:频次细分数据(即 breakdowns=frequency_value)* 营销组合模型 (MMM) 细分数据:营销组合模型 (MMM) 细分数据(即 breakdowns=mmm)将仅限于异步作业。以下端点受到影响:* GET /{ad-account-id} * GET /{campaign-id} * GET /{ad-set-id} * GET /{ad-id} * POST /{ad-account-id} * POST /{campaign-id} * POST /{ad-set-id} * POST /{ad-id}

2025年10月9日

版位 #### Messenger 收件箱 适用于 v23.0+。将于 2025 年 11 月 11 日适用于所有版本。 Messenger 收件箱版位 (messenger_home) 将不再适用于广告创建定位。以下端点将会受到影响:* GET /{ad-account-id}/adsets * POST /{ad-account-id}/adsets * GET /{ad-set-id}?fields=targeting

2025年10月6日

Threads 广告

2025年9月18日

特殊广告类别 #### 社会议题、选举和政治 适用于所有版本。 自 2025 年 10 月 6 日起,为响应欧盟政治类广告信息公示与定位 (TTPA) 法规,社会议题、选举和政治类广告将不得在欧盟投放。详细了解。 以下端点将受到影响:* POST /{ad_account_id}/campaigns * POST /{ad_account_id}/ads * POST /{ad_account_id}/adsets * POST /{ad_account_id}/adcreatives

2025年9月2日

目录 API 中的直播特价

应用到 v23.0 及以上版本

卖家可以将“live_special_price”同步到目录中的“product_item”,以此指明商品的直播专属特惠价。价格添加 2 个数位表示美分(例如:用“100”美分表示 1 美元,用“599”美分表示 5.99 美元)。

2025年8月19日

受众 #### 基本定位 将于 2025 年 8 月 19 日适用于所有版本。“COMSCORE_MARKET”代码是广告组创建流程地区定位的新地理市场来源。Comscore Markets 现在可以与现有的 DMA(指定市场区域)区域一起用作来源。以下端点将会受到影响:* POST /{ad-account-id}/adsets #### 定位搜索 将于 2025 年 8 月 19 日适用于所有版本。使用目标搜索时,COMSCORE_MARKET 代码将随 DMA 区域一起返回。以下端点将会受到影响:* GET /search

2025年8月18日

广告组预算共享

应用到 v21.0 及以上版本

我们将为广告系列创建 API 添加“is_adset_budget_sharing”字段。广告主可以通过将此字段设置为 True 来启用广告组预算共享。通过广告组预算共享,广告主现在可以与同一广告系列中的其他广告组最多共享其 20% 的预算。

下列端点受到影响:

2025年8月15日

Threads 广告

2025年5月1日

为推广对象添加含有价值语义类型的新字段

应用到 v22.0 及以上版本

为广告组推广对象添加一个新字段,以便记录投放以总价值最大化为目标的广告系列时使用的预期价值语义。

2025年3月31日

受众*于 2025 年 3 月 31 日适用于所有版本。**在“facebook_positions”中添加了“通知”版位,用于版位定位版位素材定制

2025年3月10日

广告成效分析 API 的近期变更于 2025 年 6 月 10 日适用于所有版本。2025 年 6 月 10 日,广告成效分析 API 的行为将发生两种变化:为减少与 Meta 广告管理工具的差异,“use_unified_attribution_setting”和“action_report_time”参数将被忽略,且 API 响应将模仿广告管理工具设置。如要了解详情,请访问此处的开发者文档。为了提高整体 API 性能,对于应用细分条件并使用超过 13 个月的“start_date”的查询,将不再返回“reach”;开发者可利用异步任务来请求此数据。如要了解详情,请访问此处的开发者文档。

2025年1月14日

特殊广告类别适用于所有版本。正如 2024 年 10 月所介绍,“special_ad_categories”字段有一个新的特殊广告类别输入值。该输入值就是“FINANCIAL_PRODUCTS_SERVICES”,表示[金融产品和服务] (https://www.facebook.com/business/help/510724041294968) 类别。该值将于 2025 年 1 月 14 日起替换“CREDIT”输入值。此项更改是特殊广告类别扩展的一部分,是为了在 2025 年初将金融产品和服务纳入进来。点击此处,详细了解此项更新,或访问此处的开发者文档资源页面“CREDIT”将于 2025 年 1 月 14 日停用,此后就不再是有效的特殊广告类别选项。在“CREDIT”停用前,开发者应改为使用“FINANCIAL_PRODUCTS_SERVICES”输入值,以免广告系列设置出现中断。如果 1 月 14 日后使用 CREDIT 类别创建广告,API 调用将失败并被屏蔽,还会收到错误消息。建议您在停用日期之前尽早优先处理此项更新,以尽量减少对您客户造成的干扰。与选择住房和就业类别的情况相似,已选择“FINANCIAL_PRODUCTS_SERVICES”输入值的企业必须遵循受众限制。以下端点将受到影响:*POST /{campaign-id}