登录开始免费试用
easyCoexistence 官方 API

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 洞察数据。

21 Apr 2025

impressions、plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 在每个 API 版本中被弃用的时间。

21 Jan 2025

Meta 为账户和媒体洞察数据推出 views,并向 Instagram Login 应用开放洞察数据的时间。

8 Jan 2025

video_views 及六项账户时间序列(其中包括 profile_views 和 website_clicks)在每个版本中停止支持的时间。

2 Jul 2024

2025 年 4 月 21 日之后请求 impressions 时,对于 2024 年 7 月 2 日当天或之后创建的媒体,将返回错误而非数据。

total_value

账户级 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 日所记载的最接近指标。

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_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 仍然可用。
使用 EasyCoexistence 完成这些操作

它会将您提供的指标名称原样传给 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 监控

验证时间