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 洞察數據。
impressions、plays、clips_replays_count 及 ig_reels_aggregated_all_plays_count 在所有 API 版本中被棄用的日期。
Meta 為帳戶與媒體洞察推出 views,並向 Instagram Login 應用程式開放 insights 的日期。
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 在 2025 年 4 月的棄用中同時配對了 views,並於同一更新日誌條目中列明。至於 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、帖文與限時動態中被播放或顯示的次數;在單一帖文、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 則保持可用。
它會將您提供的指標名稱原樣傳送給 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 監察
驗證日期