登入開始免費試用
easyCoexistence 官方 API

Instagram API 已棄用指標:以 views 取代 impressions 與 plays

Meta 以 views 取代 Instagram insights API 中的 impressions。Meta 於 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 應用程式開放 insights 的日期。

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 在 2025 年 4 月的棄用中同時配對了 views,並於同一更新日誌條目中列明。至於 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、帖文與限時動態中被播放或顯示的次數;在單一帖文、Reel 或限時動態上,則指它在 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 亦擴展至帖文與限時動態。
  • 2026 年 6 月 22 日:限時動態上的 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 下提供。
  • 以 profile_links_taps 按 contact_button_type 細分,取代 phone_call_clicks、email_contacts、text_message_clicks 與 get_direction_clicks。
  • 遇到指標名稱錯誤時,應視之為更新清單的提示,而非重試。

棄用如何套用至較舊的 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 天免費試用。

常見問題

phone_call_clicks 與 email_contacts 在 Instagram API 中由什麼取代?

Meta 於 2025 年 1 月 8 日在所有版本中停止支援這兩項時,並未指定直接的繼任者。其帳戶參考文件目前記載、最接近的指標是按 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,以及限時動態上的 link_clicks。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期