透過 API 查看 Facebook Reels 與影片洞察
Facebook 影片與 Reels 洞察來自 GET /{video-id}/video_insights:total_video_views 計算至少 3 秒的播放次數,total_video_avg_time_watched 與 total_video_view_total_time 以毫秒為單位提供觀看時間,而 Reels 另有 blue_reels_play_count、fb_reels_total_plays 與 fb_reels_replay_count。Meta 已於 2026 年 6 月在所有 API 版本中棄用 total_video_impressions 等影片曝光與不重複觀看者指標。
easyCoexistence 透過 get_social_insights 讀取 Facebook 專頁與貼文洞察,可從 Claude、ChatGPT 或你自己的程式使用,讓你的 AI 說明專頁及其貼文的表現;影片或 Reel 本身的 video_insights 則須在 Meta Business Suite 查看。
total_video_views 計入的最短播放時長,若影片短於此時長則接近整段長度。
Meta 何時在所有 API 版本中棄用 total_video_impressions、total_video_views_unique 與 post_video_views_unique。
影片洞察資料可回溯的時間範圍。
total_video_retention_graph 如何切分影片,並以佔全部觀看次數的百分比報告各節點的播放。
計入 blue_reels_play_count 的 Reels 播放,不包括重播。
Reels 的互動不計入專頁指標,此為 Meta 洞察參考列明的限制之一。
video_insights 會為影片返回哪些指標?
這些影片指標記載於 Meta 參考文件,截至 2026 年 11 月未列入棄用清單,均為在影片 ID 上讀取的累計總數。「觀看次數」不計入同一次播放中的重播時間,部分指標有自然流量與付費版本,例如 total_video_views_organic 與 total_video_views_paid:
哪些指標涵蓋 Reels?
Meta 參考文件設有 Reels 一節,在 Reel 的影片 ID 上讀取,數值均為累計值:
blue_reels_play_count:曝光後播放時長達 1 毫秒或以上即計入,不包括重播。fb_reels_total_plays:同一批播放,包括重播;fb_reels_replay_count:僅計同一工作階段內的重播。post_video_avg_time_watched與post_video_view_time:平均與總播放毫秒數,包括重播。post_video_followers:來自該 Reel 的追蹤。post_video_likes_by_reaction_type:該 Reel 的按讚數,按反應類型劃分。post_video_social_actions:該 Reel 的留言與分享。post_video_retention_graph:Reel 各時間點的播放次數,佔總播放的百分比。
Meta 在 2026 年棄用了哪些影片指標?
Meta 的 Graph API v25 公告於 2026 年 6 月在所有 API 版本中棄用兩組指標,並建議改用其 Media Views 與 Media Viewers 指標:用於不重複觀看者的 post_total_media_view_unique 與 page_total_media_view_unique,以及用於付費與自然流量分拆的 post_media_view 與 page_media_view。
- 影片曝光:
total_video_impressions及其不重複、付費、自然、病毒式與粉絲版本,以及貼文影片上的post_impressions_unique。 - 3 秒觀看者:
total_video_views_unique及其自然與付費版本、post_video_views_unique及其自然與付費版本,以及page_video_views_unique。
post_video_views 與 page_video_views 是否仍然有效?
是。兩者在 Meta 洞察參考文件中均無棄用標記:post_video_views 計算貼文影片至少 3 秒的播放次數,可按累計或按日統計;page_video_views 計算專頁的相應數字,可按日、週或 days_28 統計。其不重複版本 post_video_views_unique 及 page_video_views_unique 已於 2026 年 6 月對所有 API 版本棄用,10 秒指標(例如 post_video_views_10s)則在 v18 或以上版本標記為已棄用。
如何請求影片洞察?
需在三類物件上請求,每類各有其指標。GET /{video-id}/video_insights 搭配以逗號分隔的 metric 清單,可讀取影片或 Reel;若不提供 metric,則返回該影片的總數。貼文層級的影片指標,例如 post_video_views,透過 GET /{page-post-id}/insights 讀取;專頁層級的指標,例如 page_video_views,則透過 GET /{page-id}/insights 並指定 period 讀取。
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph需要哪些權限與任務?
需要來自有權在專頁上執行 ANALYZE 任務之人士的專頁存取權杖。Meta 的 video_insights 參考文件列明 read_insights 與 pages_manage_engagement,而其影片洞察指南則列明 pages_read_engagement。資料涵蓋過去 2 年;用戶或群組上的影片洞察無法取得;交叉發布的影片在其發布到的每個專頁上都有獨立的影片 ID。
專頁層級的指標是否包括 Reels?
不包括。Meta 洞察參考文件在讀取專頁指標的限制中列明,Reels 上的互動不計入其中。Reel 的播放、追蹤、留言與分享,須直接在 Reel 本身讀取,即透過其影片 ID 使用 video_insights。
easyCoexistence 如何讀取這些數據?
get_social_insights 讀取專頁或單一貼文的 insights 邊(edge):提供 metric、period,以及貼文的 object_id,並可傳遞 since、until 等額外參數。video_insights 是獨立的邊,沒有任何工具可讀取,因此影片或 Reel 本身的指標須在 Meta Business Suite 查看。已退役的指標會以 Meta 的錯誤形式返回,你的 AI 便可改用新名稱。
常見錯誤
- 請求 total_video_impressions。Meta 已於 2026 年 6 月棄用影片曝光指標;請改為請求其 Media Views 指標,例如 post_media_view。
- 將留存曲線數值相加。它們是各區間佔觀看次數的百分比,並非播放次數。
- 在專頁總數中尋找 Reels。Meta 的專頁洞察不計入 Reels 上的互動,因此應讀取每個 Reel 自身的 video_insights。
- 將觀看時間誤讀為秒。total_video_avg_time_watched、total_video_view_total_time 與 post_video_view_time 的單位是毫秒。
每個連接每月由 US$ 9 降至 US$ 0.75,連接越多單價越低,前 3 天免費。
常見問題
total_video_views_unique 已由什麼取代?
Meta 指向其 Media Viewers 指標:貼文上的 post_total_media_view_unique,以及專頁的 page_total_media_view_unique。
如何透過 API 取得 Reel 的播放次數?
讀取 blue_reels_play_count;如需包括重播,則讀取 fb_reels_total_plays。兩者均可透過 GET /{video-id}/video_insights 取得,並使用 Reel 啟動請求所返回的影片 ID。
post_impressions_unique 對 Reels 仍然有效嗎?
無效。Meta 的 Reels 表格仍列出此指標,但 v25 公告已於 2026 年 6 月在 video_insights 上棄用它;post_total_media_view_unique 則計算貼文上的不重複觀看者。
哪些影片沒有洞察數據?
在用戶或群組上發布的影片。Meta 的影片洞察涵蓋專頁上的影片,數據保存過去 2 年。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期