Метрики видео и 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 или вашего собственного кода.
Самое короткое воспроизведение, которое учитывает total_video_views, а для видео короче этого порога почти вся его длина.
Когда Meta объявила устаревшими total_video_impressions, total_video_views_unique и post_video_views_unique для всех версий API.
Как далеко назад доступны данные видеоинсайтов.
Как total_video_retention_graph делит видео, показывая воспроизведения в каждой точке в процентах от всех просмотров.
Воспроизведение, которое засчитывается как воспроизведение Reels в blue_reels_play_count, без учёта повторов.
Взаимодействия с Reels не входят в метрики Страницы; это одно из ограничений, описанных в справочнике Meta по инсайтам.
Какие метрики возвращает video_insights для видео?
Эти метрики видео есть в справочнике Meta и не входят в её списки устаревших по состоянию на ноябрь 2026 года. Все они суммарные за весь период и читаются по ID видео. Просмотры не учитывают время, проведённое в повторе внутри одного воспроизведения. У нескольких метрик есть органические и платные версии, например total_video_views_organic и total_video_views_paid.
Какие метрики относятся к 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.
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 указаны в миллисекундах.
Так ваш ИИ сможет рассказать, как дела у Страницы и её постов; собственные 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 года.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на