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

Устаревшие метрики Instagram API: impressions и plays заменены на views

Meta заменила impressions на views в API инсайтов Instagram. Метрика views появилась 21 января 2025 года, а impressions, plays, clips_replays_count и ig_reels_aggregated_all_plays_count объявлены устаревшими во всех версиях API 21 апреля 2025 года. До этого, 8 января, перестали работать video_views и шесть метрик аккаунта. Позже добавлены новые метрики, например reposts и reels_skip_rate в декабре 2025 года.

easyCoexistence читает инсайты Instagram через get_social_insights, который передаёт названия метрик, которые вы укажете, напрямую в Meta, включая views, и возвращает данные Meta или собственное сообщение Meta об ошибке, если имя метрики выведено из использования.

21 Apr 2025

Когда impressions, plays, clips_replays_count и ig_reels_aggregated_all_plays_count объявлены устаревшими во всех версиях API.

21 Jan 2025

Когда Meta ввела views для инсайтов аккаунта и медиа и открыла инсайты для приложений с Instagram Login.

8 Jan 2025

Когда video_views и шесть временных рядов аккаунта, в том числе profile_views и website_clicks, перестали поддерживаться во всех версиях.

2 Jul 2024

Медиа, созданное на или после этой даты, возвращает ошибку, а не данные, если запросить impressions после 21 апреля 2025 года.

total_value

Единственный metric_type, который принимает метрика views на уровне аккаунта; у impressions был также ежедневный time_series.

Какие метрики Instagram Meta убрала в 2025 году?

Два этапа, каждый объявлен за несколько месяцев в журнале изменений Meta. Сначала отключение применялось из новой версии Graph API, затем ко всем версиям:

  • 8 января 2025: video_views на медиа и временные ряды аккаунта email_contacts, get_direction_clicks, phone_call_clicks, profile_views, text_message_clicks и website_clicks, впервые убраны в v21.0.
  • 21 января 2025: impressions в инсайтах аккаунта и медиа, а также plays, clips_replays_count и ig_reels_aggregated_all_plays_count на медиа, устаревшими для v22.0 и новее, в день появления views.
  • 21 апреля 2025: эти четыре метрики объявлены устаревшими во всех версиях API.

Чем заменить каждую выведенную метрику?

Meta связала views с отключениями апреля 2025 года в одной записи журнала изменений. Для январских метрик преемника не назвали, поэтому правая колонка таблицы даёт ближайшую метрику, которую справочники аккаунта и медиа документировали по состоянию на 31 октября 2026 г.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_activity per post, whose action_type includes BIO_LINK_CLICKED

Возвращает ли impressions что-нибудь сейчас?

Только для старых медиа. В журнале изменений Meta сказано, что запросы после 21 апреля 2025 года для медиа, созданных на или после 2 июля 2024 года, возвращают ошибку, а справочник медиа-инсайтов сохраняет impressions только для медиа, созданных раньше этой даты. На уровне аккаунта impressions устарела во всех версиях, поэтому код, написанный сегодня, не получит от неё пользы.

Что считает views?

На уровне аккаунта это число воспроизведений или показов контента в Reels, публикациях и Stories; для отдельной публикации, Reel или Story это число воспроизведений в Instagram. impressions считала показы контента на экране, включая рекламу, поэтому график, который переходит с одной метрики на другую, меняет то, что измеряет, в момент переключения. Метрика views на уровне аккаунта принимает только metric_type=total_value и делится по media_product_type, а Meta по-прежнему помечает её как «в разработке».

Какие метрики Meta добавила с тех пор?

В журнале изменений Meta перечислены такие добавления после отключений 2025 года:

  • 3 декабря 2025: reels_skip_rate и reposts на медиа, reposts на аккаунте, а также crossposted_views и facebook_views для Reels, опубликованных через кросспостинг.
  • 22 апреля 2026: total_likes, total_comments и total_views, агрегированные по всем разделам Meta и включающие продвигаемые медиа, которые справочник Meta предлагает только с Facebook Login; facebook_views также распространили на посты и Stories.
  • 22 июня 2026: link_clicks на Stories, которые считают нажатия на ссылки, например стикеры-ссылки; журнал изменений ограничивает их Facebook Login.

Что нужно изменить в коде?

Список метрик, написанный до 2025 года, требует этих изменений, чтобы продолжать работать:

  • Замените impressions, plays, clips_replays_count, ig_reels_aggregated_all_plays_count и video_views на views, и в запросах к аккаунту, и в запросах к медиа.
  • Запрашивайте метрику views на уровне аккаунта с metric_type=total_value. У неё нет time_series, поэтому там, где impressions давала ежедневную линию, читайте одно итоговое значение за период.
  • Запрашивайте crossposted_views и facebook_views только для кросспостинговых медиа, отдельным запросом: справочник Meta говорит, что оба вызывают ошибку, если медиа не публиковалось через кросспостинг.
  • Не включайте total_likes, total_comments и total_views в приложения с Instagram Login, так как Meta предлагает их только с Facebook Login.
  • Замените phone_call_clicks, email_contacts, text_message_clicks и get_direction_clicks на profile_links_taps с разбивкой по contact_button_type.
  • Ошибку с именем метрики считайте сигналом обновить список, а не повторять запрос.

Как устаревание доходит до старых версий API?

В два этапа. Изменение сначала применяется из новой версии Graph API, v21.0 для video_views и v22.0 для impressions, а затем распространяется на все версии в дату, указанную в той же записи журнала, примерно через три месяца в обоих случаях. Фиксация старой версии даёт самое большее несколько месяцев, а журнал изменений Meta для Instagram Platform указывает обе даты для каждого изменения.

Какие более ранние отключения всё ещё ломают старый код?

Два отключения до 2025 года проявляются в коде, который не трогали с тех пор:

  • 11 декабря 2023: метрики carousel_album, taps_forward, taps_back, exits и engagement на медиа, а также audience_gender_age, audience_locale, audience_country и audience_city на аккаунте; follower_demographics теперь охватывает возраст, город, страну и пол.
  • 19 августа 2024: временные рамки last_14_days, last_30_days, last_90_days и prev_month для engaged_audience_demographics и reached_audience_demographics; this_week и this_month остаются.

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

  • Запрос impressions для публикации, опубликованной с июля 2024 года. Meta возвращает ошибку для таких медиа; запрашивайте views.
  • Запрос views аккаунта как time_series. Meta документирует её только с total_value, поэтому читайте итог для каждого нужного периода.
  • Запрос crossposted_views или facebook_views для медиа, которое никогда не публиковалось через кросспостинг. Справочник Meta говорит, что оба вызывают ошибку в этом случае.
  • Ожидание total_likes, total_comments или total_views с Instagram Login. Meta предоставляет их только с Facebook Login; likes, comments и views остаются.
Настройка с EasyCoexistence

Так Claude, ChatGPT или ваш код могут следовать за переименованием в тот же день, когда Meta его вводит. US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений; первые 3 дня бесплатно.

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

Чем заменили phone_call_clicks и email_contacts в Instagram API?

Meta не назвала прямого преемника, когда эти метрики перестали поддерживаться во всех версиях 8 января 2025 года. Ближайшая метрика, которую её справочник аккаунта описывает сегодня, это profile_links_taps с разбивкой по contact_button_type.

Чем заменили воспроизведения Reels в Instagram?

Метрикой views. Meta объявила устаревшими plays, clips_replays_count и ig_reels_aggregated_all_plays_count во всех версиях API 21 апреля 2025 года, через три месяца после введения views.

Почему мой вызов инсайтов Instagram начал падать?

Сначала проверьте список метрик: impressions, plays, video_views и старые метрики профиля выведены из использования, а views аккаунта принимает только total_value. Повтор того же запроса вернёт ту же ошибку.

Выводила ли Meta какие-либо метрики Instagram в 2026 году?

В журнале изменений Instagram от Meta по 28 октября 2026 года таких нет. Записи 2026 года добавляют метрики, среди них total_views, расширенная facebook_views и link_clicks на Stories.

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

Статистика Instagram через API: метрики аккаунта и постовМетрики, которые API Instagram возвращает для аккаунта и каждого поста, Reels и Stories, с порогами Meta, задержками и переименованными метриками.Ограничения Instagram API: вызовы за 24 часа и пропускная способность личных сообщенийОграничения Instagram API: 4 800 вызовов на показ за 24 часа, 100 сообщений в секунду, 750 частных ответов в час и ошибка 80002.Отключение Instagram Basic Display API: что закрылось и как перейтиС 4 декабря 2024 года Instagram Basic Display API не работает. Что это было, чем его заменили для профессиональных аккаунтов и как перенести приложение.Пробные Reels в Instagram через API: trial_params и переход в обычный режимПубликация пробных Reels в Instagram через API: trial_params в контейнере REELS, переход MANUAL или SS_PERFORMANCE и поддержка Instagram Login.Ошибки Instagram API: что означают распространённые кодыЧастые ошибки Instagram API: истёкшие токены, лимиты частоты, медиа, которые Meta не может загрузить, дневной лимит публикаций, закрытые окна переписки.Публикация Reels в Instagram через APIКак Instagram API публикует Reels: требования Meta к видео, контейнеры и время обработки, показ в Feed, обложки и метрики Reels.

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

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

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

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