Introducing Graph API v25.0 and Marketing API v25.0

摘要

Meta今日宣布Graph API和Marketing API v25.0版本更新，核心变化包括引入新的Page Viewer Metric，该指标旨在统一Facebook和Instagram的内容触达测量标准，替代原有的reach指标。开发者需在2026年6月前迁移至viewers指标，以持续获得受众洞察。

在安全方面，Webhooks mTLS证书将于2026年3月31日从DigiCert根CA切换至Meta内部根CA，现有证书因DigiCert弃用Client Authentication EKU而无法续期。开发者必须下载并信任新的Meta根证书（meta-outbound-api-ca-2025-12.pem），否则将导致TLS握手失败，Webhooks事件接收中断。

API功能调整方面，metadata=1查询参数在v25.0中弃用，并在2026年5月彻底移除，开发者应转向官方文档获取节点字段信息。同时，Ads Insights Async API的GET {AD_REPORT_RUN_ID}端点新增error_code、error_message等错误字段，提升异步报告失败的调试能力。

Metrics层面，大量传统指标面临弃用：page impressions、post impressions、video impressions及其细分指标（paid、organic、viral等）将在2026年6月后失效；3-second viewers指标同步弃用，建议切换至page_total_media_view_unique和post_total_media_view_unique。对于付费与自然覆盖的细分，推荐使用page_media_view和post_media_view。

营销API方面，从v25.0（2026年2月18日）起，ASC（Advantage+ Shopping Campaign）和AAC（Advantage+ App Campaign）广告无法通过API创建或更新，90天后（2026年5月19日）扩展至所有MAPI版本。到v26.0（预计2026年9月），所有现有ASC/AAC广告将被暂停。使用ECBC（Existing Customer Budget Caps）的ASC/AAC广告在v26.0前仍可编辑，开发者需通过手动复制、API复制或联系Meta合作伙伴批量迁移至Advantage+广告。同时，API版本弃用时间表确认：v19于2026年5月21日、v20于2026年9月24日下线。