Instagram API 已弃用指标:impressions 和 plays 改为 views
Meta 在 Instagram 洞察数据 API 中以 views 取代 impressions。2025 年 1 月 21 日推出 views,并于 2025 年 4 月 21 日在每个 API 版本中弃用 impressions、plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count。此前,video_views 及六项账户指标已于 1 月 8 日停止支持。后续更新新增了指标,例如 2025 年 12 月新增的 reposts 和 reels_skip_rate。
easyCoexistence 通过 get_social_insights 读取 Instagram 洞察数据。
impressions、plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 在每个 API 版本中被弃用的时间。
Meta 为账户和媒体洞察数据推出 views,并向 Instagram Login 应用开放洞察数据的时间。
video_views 及六项账户时间序列(其中包括 profile_views 和 website_clicks)在每个版本中停止支持的时间。
2025 年 4 月 21 日之后请求 impressions 时,对于 2024 年 7 月 2 日当天或之后创建的媒体,将返回错误而非数据。
账户级 views 唯一接受的 metric_type;impressions 还提供每日的 time_series。
Meta 在 2025 年停用了哪些 Instagram 指标?
分两轮进行,每轮都提前在 Meta 的更新日志中公布,先从新的 Graph API 版本开始,随后应用到所有版本:
- 2025 年 1 月 8 日:媒体上的
video_views,以及账户时间序列email_contacts、get_direction_clicks、phone_call_clicks、profile_views、text_message_clicks和website_clicks,首先在 v21.0 中移除。 - 2025 年 1 月 21 日:账户和媒体洞察数据中的 impressions,以及媒体上的 plays、
clips_replays_count和ig_reels_aggregated_all_plays_count,在 v22.0 及更高版本中弃用,与 views 推出的当天同步。 - 2025 年 4 月 21 日:上述四项在每个 API 版本中均被弃用。
每个已停用的指标应改为什么?
Meta 在同一更新日志条目中将 views 与 2025 年 4 月的停用配对。对于 1 月的指标,Meta 没有指定替代者,因此右侧一栏列出了其账户和媒体参考文档截至 2026 年 10 月 31 日所记载的最接近指标。
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
impressions 还会返回数据吗?
仅限较早的媒体。Meta 的更新日志称,2025 年 4 月 21 日之后,对于 2024 年 7 月 2 日当天或之后创建的媒体发出的请求会返回错误,其媒体洞察数据参考文档仅保留该日期之前创建的媒体的 impressions。在账户层面,impressions 在每个版本中均已弃用,因此今天编写的代码无需使用它。
views 统计的是什么?
在账户层面,是内容在 Reels、帖子和 Stories 中被播放或展示的次数;对于单条帖子、Reel 或 Story,则是它在 Instagram 上被播放的次数。impressions 统计的是内容在屏幕上出现的次数(包括广告),因此连续跨越两者的图表会在切换处改变其衡量的内容。账户级 views 只接受 metric_type=total_value,并按 media_product_type 细分,Meta 仍将其标记为开发中。
此后 Meta 新增了哪些指标?
Meta 的更新日志列出了 2025 年停用之后的这些新增项:
- 2025 年 12 月 3 日:媒体上的
reels_skip_rate和 reposts,账户上的 reposts,以及跨平台发布的 Reels 的crossposted_views和facebook_views。 - 2026 年 4 月 22 日:
total_likes、total_comments和total_views,跨平台汇总且包括推广媒体,Meta 的参考文档仅在 Facebook Login 下提供;facebook_views也扩展到帖子和 Stories。 - 2026 年 6 月 22 日:Stories 上的
link_clicks,统计对链接(如链接贴纸)的点击,更新日志将其限制在 Facebook Login 下。
代码中需要做哪些改动?
2025 年之前编写的指标列表需要以下改动才能继续工作:
- 将账户和媒体请求中的 impressions、plays、
clips_replays_count、ig_reels_aggregated_all_plays_count和video_views全部替换为 views。 - 使用
metric_type=total_value请求账户级 views。它没有time_series,因此在过去 impressions 提供每日曲线的地方,需要为每个时间范围读取一个总计值。 - 仅在跨平台发布的媒体上请求
crossposted_views和facebook_views,并单独发起请求:Meta 的参考文档称,若媒体未跨平台发布,两者都会抛出错误。 - 不要在 Instagram Login 应用中使用
total_likes、total_comments和total_views,因为 Meta 仅在 Facebook Login 下提供它们。 - 将
phone_call_clicks、email_contacts、text_message_clicks和get_direction_clicks替换为按contact_button_type细分的profile_links_taps。 - 将指标名称的错误视为更新列表的提示,而不是重试的理由。
弃用如何影响较早的 API 版本?
分两步进行。更改会先从新的 Graph API 版本开始应用:video_views 为 v21.0,impressions 为 v22.0;然后在同一更新日志条目中给出的日期应用到所有版本,两种情况都约相隔三个月。锁定较早的版本最多只能争取几个月的时间,而 Meta 的 Instagram Platform 更新日志为每项更改都列出了两个日期。
哪些较早的停用仍会影响旧代码?
2025 年之前的两项停用,会出现在长期未更新的代码中:
- 2023 年 12 月 11 日:
carousel_album指标、媒体上的taps_forward、taps_back、exits 和 engagement,以及账户上的audience_gender_age、audience_locale、audience_country和audience_city;现在follower_demographics涵盖年龄、城市、国家和性别。 - 2024 年 8 月 19 日:
engaged_audience_demographics和reached_audience_demographics的last_14_days、last_30_days、last_90_days和prev_month时间范围;this_week和this_month仍然保留。
常见错误
- 对 2024 年 7 月之后发布的帖子请求 impressions。Meta 会对该媒体返回错误;请改为请求 views。
- 将账户 views 作为 time_series 请求。Meta 仅以 total_value 记录它,因此请为所需的每个时间范围读取一个总计值。
- 为从未跨平台发布的媒体请求 crossposted_views 或 facebook_views。Meta 的参考文档称,这种情况下两者都会抛出错误。
- 期望在 Instagram Login 下获得 total_likes、total_comments 或 total_views。Meta 仅在 Facebook Login 下提供它们;likes、comments 和 views 仍然可用。
它会将您提供的指标名称原样传给 Meta,包括 views,并返回 Meta 的数据;当某个名称已停用时,则返回 Meta 自己的错误信息。因此,Claude、ChatGPT 或您自己的代码可以在 Meta 做出改名的当天跟随调整。每个连接每月从 US$ 9 降至 US$ 0.75,连接越多价格越低,前 3 天免费。
常见问题
Instagram API 中什么替代了 phone_call_clicks 和 email_contacts?
这两项于 2025 年 1 月 8 日在每个版本中停止支持时,Meta 没有指定直接的替代者。其账户参考文档目前记载的最接近指标是按 contact_button_type 细分的 profile_links_taps。
什么替代了 Instagram Reels 上的 plays?
views。Meta 在推出 views 三个月后,于 2025 年 4 月 21 日在每个 API 版本中弃用了 plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count。
为什么我的 Instagram 洞察数据调用开始失败?
请先检查指标列表:impressions、plays、video_views 和旧的个人资料指标已停用,账户 views 只接受 total_value。重试同一请求只会返回同样的错误。
Meta 在 2026 年是否停用过任何 Instagram 指标?
截至 2026 年 10 月 28 日,Meta 的 Instagram 更新日志中没有出现停用项。其 2026 年的条目反而新增指标,其中包括 total_views、范围更广的 facebook_views,以及 Stories 上的 link_clicks。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间