ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Метрики видео и Reels Facebook через API

Данные видео и Reels Facebook поступают из 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. В июне 2026 года Meta объявила устаревшими метрики показов видео и уникальных зрителей, такие как total_video_impressions, для всех версий API.

easyCoexistence читает инсайты Страницы Facebook и публикаций через get_social_insights из Claude, ChatGPT или вашего собственного кода.

3 seconds

Самое короткое воспроизведение, которое учитывает total_video_views, а для видео короче этого порога почти вся его длина.

June 2026

Когда Meta объявила устаревшими total_video_impressions, total_video_views_unique и post_video_views_unique для всех версий API.

2 years

Как далеко назад доступны данные видеоинсайтов.

40 intervals

Как total_video_retention_graph делит видео, показывая воспроизведения в каждой точке в процентах от всех просмотров.

1 ms

Воспроизведение, которое засчитывается как воспроизведение Reels в blue_reels_play_count, без учёта повторов.

Reels left out

Взаимодействия с Reels не входят в метрики Страницы; это одно из ограничений, описанных в справочнике Meta по инсайтам.

Какие метрики возвращает video_insights для видео?

Эти метрики видео есть в справочнике Meta и не входят в её списки устаревших по состоянию на ноябрь 2026 года. Все они суммарные за весь период и читаются по ID видео. Просмотры не учитывают время, проведённое в повторе внутри одного воспроизведения. У нескольких метрик есть органические и платные версии, например total_video_views_organic и 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

Какие метрики относятся к Reels?

В справочнике Meta есть раздел Reels. Метрики читаются по ID видео Reels, значения суммарные за весь период:

  • 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: подписки, полученные с Reels.
  • post_video_likes_by_reaction_type: лайки на Reels.
  • post_video_social_actions: комментарии и репосты.
  • post_video_retention_graph: воспроизведения в точках Reels в процентах от всех воспроизведений.

Какие метрики видео Meta объявила устаревшими в 2026 году?

В объявлении о Graph API v25 от июня 2026 года Meta признала устаревшими две группы метрик для всех версий 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 считает воспроизведения Страницы по дням, неделям или за 28 дней (days_28). Их уникальные версии, post_video_views_unique и page_video_views_unique, были отмечены как устаревшие в июне 2026 года для всех версий API, а метрики 10 секунд, например post_video_views_10s, в версиях выше v18.

Как запрашиваются видеоинсайты?

На трёх объектах, у каждого свои метрики. GET /{video-id}/video_insights с параметром metric, где метрики перечислены через запятую, читает видео или Reels, а без metric возвращает суммарные показатели видео. Метрики уровня публикации, например post_video_views, читаются через GET /{page-post-id}/insights, а метрики уровня Страницы, например page_video_views, через GET /{page-id}/insights с параметром 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

Какие права и задача нужны?

Токен Страницы от пользователя, который может выполнять задачу ANALYZE на Странице. В справочнике Meta по video_insights указаны read_insights и pages_manage_engagement, а в руководстве по видеоинсайтам указано pages_read_engagement. Данные охватывают последние 2 года. Инсайты для видео на профилях пользователей или в группах недоступны. Кросс-публикация имеет отдельный ID видео на каждой Странице, на которую она была опубликована.

Включают ли метрики уровня Страницы Reels?

Нет. В справочнике Meta по инсайтам среди ограничений чтения метрик Страницы указано, что взаимодействия с Reels не учитываются. Воспроизведения, подписки, комментарии и репосты Reels читаются у самого Reels через video_insights по его ID видео.

Как EasyCoexistence читает эти метрики?

get_social_insights читает эндпоинт инсайтов Страницы или одной публикации: метрики, период и object_id для публикации; дополнительные параметры, например since и until, передаются дальше. video_insights является отдельным эндпоинтом, который не читает ни один инструмент, поэтому собственные метрики видео или Reels читаются в Meta Business Suite. Снятая метрика возвращает ошибку Meta, и ваш ИИ может заменить название.

Распространённые ошибки

  • Запрос total_video_impressions. Meta объявила устаревшими метрики показов видео в июне 2026 года; запрашивайте вместо них метрики Media Views, например post_media_view.
  • Суммирование значений графика удержания. Это проценты от просмотров в каждом интервале, а не количество воспроизведений.
  • Поиск Reels в суммарных показателях Страницы. Инсайты Страницы не учитывают взаимодействия с Reels, поэтому читайте video_insights каждого Reels.
  • Чтение времени просмотра в секундах. total_video_avg_time_watched, total_video_view_total_time и post_video_view_time указаны в миллисекундах.
Настройка с EasyCoexistence

Так ваш ИИ сможет рассказать, как дела у Страницы и её постов; собственные video_insights видео или Reels читаются в Meta Business Suite. От US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений; первые 3 дня бесплатно.

Часто задаваемые вопросы

Что заменило total_video_views_unique?

Meta указывает на свои метрики Media Viewers: post_total_media_view_unique для публикации и page_total_media_view_unique для Страницы.

Как получить воспроизведения Reels через API?

Читайте blue_reels_play_count или fb_reels_total_plays, если нужно учитывать повторы, из GET /{video-id}/video_insights с ID видео, который вернул запрос на старт Reels.

Работает ли post_impressions_unique для Reels?

Нет. Таблица Reels у Meta ещё указывает эту метрику, но в объявлении v25 в июне 2026 года её сняли с video_insights; post_total_media_view_unique считает уникальных зрителей публикации.

У каких видео нет инсайтов?

У видео, опубликованных на профилях пользователей или в группах. Видеоинсайты Meta охватывают видео на Страницах, данные за последние 2 года.

Читайте дальше

Facebook Reels API: публикация Reels на СтраницеКак Facebook Reels API публикует Reels на Странице: вызовы start, upload и finish на video_reels, требования Meta к видео, лимит 30 в сутки и статус.Публикация видео на Facebook Page через APIКак опубликовать видео на Facebook Page через Graph API: file_url или загруженный файл на /videos, заголовок, описание и статус обработки.Получение постов Страницы Facebook через API: feed, posts и published_postsКак получить посты Страницы Facebook через Graph API: сравнение feed, posts и published_posts, полезные поля, постраничная навигация и ограничения Meta.Метрики Facebook Page Insights в 2026 году: какие работают и какие Meta отключилаКакие метрики Facebook Page Insights работают в конце 2026 года, а какие Meta отключила, с датами: page_impressions, page_fans, охват и другие.Разрешения Facebook Page API и требования App ReviewДевять разрешений Facebook Page, что открывает каждое и что App Review требует: расширенный доступ, верификация бизнеса, запись экрана.Бесплатен ли API Facebook? Цены на API Страниц и Messenger в 2026 годуВызовы API Страниц Facebook и Messenger Platform в 2026 году бесплатны. Meta берёт плату за рекламу и маркетинговые сообщения, а доступ идёт через App Review.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на