Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Reels i video insights na Facebooku przez API

Statystyki wideo i Reels na Facebooku pochodzą z GET /{video-id}/video_insights: total_video_views liczy odtworzenia trwające co najmniej 3 sekundy, total_video_avg_time_watched i total_video_view_total_time podają czas oglądania w milisekundach, a dla Reels dostępne są blue_reels_play_count, fb_reels_total_plays i fb_reels_replay_count. Meta wycofała w czerwcu 2026 roku, dla wszystkich wersji API, metryki wyświetleń wideo i unikalnych widzów, takie jak total_video_impressions.

easyCoexistence odczytuje metryki stron i postów Facebooka przez get_social_insights z poziomu Claude, ChatGPT lub własnego kodu, dzięki czemu Twoja AI powie, jak radzą sobie strona i jej posty; własne video_insights wideo lub Reela odczytuje się w Meta Business Suite.

3 seconds

Najkrótszy czas odtworzenia, od którego total_video_views liczy odtworzenie, albo prawie pełna długość filmów krótszych od tego progu.

June 2026

Kiedy Meta wycofała total_video_impressions, total_video_views_unique i post_video_views_unique dla wszystkich wersji API.

2 years

Jak daleko wstecz dostępne są dane video insights.

40 intervals

Jak total_video_retention_graph dzieli film i podaje odtworzenia na każdym odcinku jako procent wszystkich wyświetleń.

1 ms

Odtworzenia liczone jako odtworzenie Reels w blue_reels_play_count, bez powtórek.

Reels left out

Interakcje na Reels nie są wliczane do metryk Strony, co wymienia się wśród ograniczeń w dokumentacji insights Meta.

Jakie metryki zwraca video_insights dla wideo?

Te metryki wideo są w dokumentacji Meta i nie znajdują się na listach wycofanych według stanu na listopad 2026 roku. Wszystkie to sumy od początku, odczytywane z ID wideo. Wyświetlenia nie uwzględniają czasu spędzonego na powtórkach w obrębie jednego odtworzenia, a kilka z nich ma wersje organiczne i płatne, na przykład total_video_views_organic i total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

Jakie metryki obejmują Reels?

Dokumentacja Meta ma sekcję Reels, odczytywaną z ID wideo Reela, z wartościami od początku:

  • blue_reels_play_count: odtworzenia trwające 1 milisekundę lub dłużej po zliczeniu wyświetlenia, bez powtórek.
  • fb_reels_total_plays: te same odtworzenia wraz z powtórkami; fb_reels_replay_count: same powtórki w tej samej sesji.
  • post_video_avg_time_watched i post_video_view_time: średni i łączny czas odtwarzania w milisekundach, wraz z powtórkami.
  • post_video_followers: nowe obserwacje z Reela.
  • post_video_likes_by_reaction_type: polubienia Reela.
  • post_video_social_actions: jego komentarze i udostępnienia.
  • post_video_retention_graph: odtworzenia w punktach Reela, jako procent wszystkich odtworzeń.

Które metryki wideo Meta wycofała w 2026 roku?

W ogłoszeniu Meta o Graph API v25 wycofano w czerwcu 2026 roku dwie grupy dla wszystkich wersji API i wskazano zamiast nich metryki Media Views i Media Viewers: post_total_media_view_unique i page_total_media_view_unique dla unikalnych widzów oraz post_media_view i page_media_view dla podziału na płatne i organiczne:

  • Wyświetlenia wideo: total_video_impressions z wariantami unikalnym, płatnym, organicznym, wiralowym i fanowym oraz post_impressions_unique przy filmie.
  • Widzowie po 3 sekundach: total_video_views_unique i jego wersje organiczna i płatna, post_video_views_unique i jego wersje organiczna i płatna oraz page_video_views_unique.

Czy post_video_views i page_video_views nadal działają?

Tak. Obie pozostają w dokumentacji insights Meta bez oznaczenia wycofania: post_video_views liczy odtworzenia wideo z posta trwające co najmniej 3 sekundy, w ujęciu od początku lub dziennym, a page_video_views liczy je dla Strony, dziennie, tygodniowo lub w okresie days_28. Ich wersje unikalne, post_video_views_unique i page_video_views_unique, zostały wycofane w czerwcu 2026 roku dla wszystkich wersji API, a metryki 10-sekundowe, na przykład post_video_views_10s, w wersjach powyżej v18.

Jak żąda się video insights?

Z trzech obiektów, każdy z własnymi metrykami. GET /{video-id}/video_insights z parametrem metric jako listą oddzieloną przecinkami odczytuje wideo lub Reel, a bez metric zwraca sumy wideo. Metryki na poziomie posta, na przykład post_video_views, odczytuje się przez GET /{page-post-id}/insights, a na poziomie Strony, na przykład page_video_views, przez GET /{page-id}/insights z parametrem period.

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

Jakie uprawnienia i zadanie są potrzebne?

Token strony od osoby, która może wykonać zadanie ANALYZE na Stronie. W dokumentacji Meta video_insights wymieniane są read_insights i pages_manage_engagement, a przewodnik po video insights wymienia pages_read_engagement. Dane obejmują ostatnie 2 lata, insights dla wideo na profilach użytkowników lub w grupach nie są dostępne, a wideo opublikowane krzyżowo ma osobne ID wideo na każdej Stronie, na którą zostało opublikowane.

Czy metryki na poziomie Strony obejmują Reels?

Nie. Dokumentacja insights Meta wymienia wśród ograniczeń odczytu metryk Strony to, że interakcje na Reels nie są wliczane. Odtworzenia, obserwacje, komentarze i udostępnienia Reela odczytuje się bezpośrednio na nim, przez video_insights z jego ID wideo.

Jak easyCoexistence je odczytuje?

get_social_insights odczytuje edge insights Strony lub jednego posta: metryki, okres i object_id dla posta, z przekazywanymi dalej dodatkowymi parametrami, takimi jak since i until. video_insights to osobny edge, którego nie odczytuje żadne narzędzie, więc metryki wideo lub Reela odczytuje się w Meta Business Suite. Wycofana metryka wraca jako błąd Meta, dzięki czemu Twoja AI może przełączyć się na inną nazwę.

Typowe błędy

  • Żądanie total_video_impressions. Meta wycofała metryki wyświetleń wideo w czerwcu 2026 roku; zamiast nich poproś o metryki Media Views, na przykład post_media_view.
  • Sumowanie wartości z retention graph. To procenty wyświetleń na każdym przedziale, a nie liczba odtworzeń.
  • Szukanie Reels w sumach Strony. Metryki Strony nie uwzględniają interakcji na Reels, więc odczytaj video_insights każdego Reela.
  • Traktowanie czasu oglądania jako sekund. total_video_avg_time_watched, total_video_view_total_time i post_video_view_time są w milisekundach.
Z EasyCoexistence zrobisz to

US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem kolejnych połączeń, z pierwszymi 3 dniami bezpłatnego okresu próbnego.

Najczęściej zadawane pytania

Co zastąpiło total_video_views_unique?

Meta wskazuje metryki Media Viewers: post_total_media_view_unique przy poście oraz page_total_media_view_unique dla Strony.

Jak pobrać odtworzenia Reela przez API?

Odczytaj blue_reels_play_count albo fb_reels_total_plays, aby uwzględnić powtórki, z GET /{video-id}/video_insights, używając ID wideo zwróconego przez wywołanie startowe Reela.

Czy post_impressions_unique nadal działa dla Reels?

Nie. Tabela Reels w dokumentacji Meta nadal ją wymienia, ale ogłoszenie v25 wycofało ją z video_insights w czerwcu 2026 roku; post_total_media_view_unique liczy unikalnych widzów posta.

Które wideo nie ma insights?

Filmy opublikowane na profilach użytkowników lub w grupach. Video insights Meta obejmują filmy na Stronach, z danymi z ostatnich 2 lat.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w