Представляем Graph API 25.0 и Marketing API 25.0

Ниже приведены основные изменения в GAPI и MAPI в версии 25. Полный список изменений и подробные сведения см. в журнале изменений.

Общие обновления

Graph API: новая метрика зрителей Страницы

К концу июня 2026 года мы планируем внедрить метрику зрителей Страницы в Graph API. Метрика "Зрители" заменила устаревшую метрику "Охват" и поддерживает кросс-платформенное изменение количества просмотревших определенный контент на Facebook и в Instagram. Разработчикам стоит запланировать перенос своих кампаний на метрику зрителей, чтобы не потерять доступ к статистике аудитории.

Что изменится?

Метрики зрителей будут доступны в статистике Страницы и историй.

Статистика публикаций или Страницы

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

Статистика историй

• Добавление новой метрики
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

Перечисленные выше Graph API станут доступны после выпуска версии 25. Рекомендуем разработчикам проверять актуальную информацию в журнале изменений Graph API.

Обновление сертификата mTLS для Webhooks

С 31 марта 2026 г. Meta начнет подписывать сертификаты mTLS для Webhooks с использованием другого центра сертификации (ЦС), принадлежащего Meta.

Что это означает для разработчиков?

Если ваши серверы настроены таким образом, что для них требуется проверяемый сертификат Webhooks mTLS, вам необходимо добавить новый сертификат, подписанный ЦС Meta, в список доверенных сертификатов. Если не обновить хранилище доверенных сертификатов до указанного срока, установить соединение по протоколу TLS не удастся, и ваши серверы перестанут получать события Webhooks.

Требуется действие: обновите хранилище доверенных сертификатов

Чтобы получать события Webhooks без перебоев, вам потребуется:

1. Скачайте корневой сертификат центра сертификации Meta. Перейдите в раздел Начало работы с Webhooks и скачайте файл под названием meta-outbound-api-ca-2025-12.pem.
   Корневой центр сертификации подпишет сертификат конечной точки, который будет представлен в запросах Webhooks.
2. Добавьте сертификат в хранилище доверенных сертификатов всех серверов, получающих Webhooks.
3. Обновите текущий сертификат. Добавьте новый сертификат в хранилище доверенных сертификатов, пока текущий ещё активен.

Важно! Не ждите, пока срок действия текущего сертификата истечет. Добавьте новый сертификат в хранилище как можно скорее, чтобы упростить переход 31 марта.

Крайний срок: до 31 марта 2026 года.

Почему мы вводим такие изменения?

Текущий сертификат Webhooks mTLS подписывает корневой центр сертификации DigiCert. Поскольку компания DigiCert прекращает поддержку Client Authentication EKU, сертификат будет невозможно обновить после истечения его срока действия 15 апреля 2025 года.

Поэтому новый сертификат Webhooks mTLS будет подписывать внутренний корневой центр сертификации Meta. У него будет то же общее название (client.webhooks.fbclientcerts.com), что и у текущего сертификата.

Мы добавили уведомление об этом изменении в Общедоступную документацию о Webhooks mTLS. Полная техническая информация в документации будет обновлена в апреле 2026 года после завершения перехода.

Упраздненные элементы и важные изменения

Улучшенные сообщения об ошибках для Ads Insights Async API

Мы постоянно работаем над тем, чтобы разработчикам было удобнее пользоваться нашими API. Мы стремимся повысить прозрачность и дать разработчикам возможность создавать более надежные приложения, поэтому улучшаем отчетность об ошибках для конечной точки Ads Insights Async API GET {AD_REPORT_RUN_ID}.

Начиная с версии Graph API 25.0, которая выйдет 18 февраля 2026 года, разработчики смогут получать подробную информацию об ошибках при сбое асинхронного отчета. Это упростит диагностику и повысит эффективность интеграции API. Для разработчиков, которым на данный момент доступно поле error_code, его тип изменится с uint на int.

Что изменится?

Мы добавили в ответ конечной точки GET {AD_REPORT_RUN_ID} Ads Insights Async API для всех приложений следующие поля по умолчанию:

• error_code — код ошибки. Примечание. Поле изменится с uint на int для всех разработчиков, у которых есть к нему доступ.
• error_message — сообщение, соответствующее ошибке error_code.
• error_subcode — конкретный подкод ошибки.
• error_user_title — понятное пользователям название подкода ошибки.
• error_user_msg — понятное пользователям сообщение с указанием подкода ошибки.

Эти поля заполняются, если не удается загрузить отчет. Рекомендуем проверить совместимость интеграции API с новыми полями в ответе по умолчанию.

Это обновление будет выпущено вместе с новой версией Graph API. Рекомендуем разработчикам проверять актуальную информацию в журнале изменений Graph API. Эти изменения также внесены в Документацию для разработчиков.

Graph API: прекращение поддержки параметра запроса метаданных

Начиная с Graph API версии 25 мы прекращаем поддержку параметра запроса metadata=1. Раньше этот параметр использовался для возврата метаданных о полях и подключениях узла в ответах API. Эта функция используется редко и будет упразднена для упрощения работы с платформой. После прекращения поддержки параметр metadata будет игнорироваться в запросах API.

Разработчикам, которые сейчас используют параметр metadata=1, стоит ознакомиться с официальной документацией API, чтобы узнать, какие поля и связи доступны для каждого типа узла.

Что изменится?

До (версия 24 и более ранние):

Добавление ?metadata=1 в запрос Graph API возвращает дополнительные метаданные об узле, в том числе доступных полях и связях.

После (версия 25 и более поздние):

Параметр metadata=1 будет игнорироваться. Запросы с этим параметром по-прежнему будут возвращать стандартные ответы без метаданных. Это изменение не приведет к сбоям или нарушениям. Запросы с параметром metadata=1 НЕ будут прерываться или возвращать ошибку. Параметр просто не будет влиять на них.

Graph API: прекращение поддержки метрик охвата и показов для Страницы

В июне 2026 года мы планируем прекратить поддержку метрик "Охват публикации", "Охват Страницы", "Показы видео" и "Показы истории" в Graph API. Эти метрики устарели и больше не показываются в наших инструментах статистики, однако всё ещё были доступны через API.

Чтобы привести наши продукты и API к единому набору метрик, а также повысить общую надежность системы, мы прекращаем поддержку устаревших метрик. После прекращения поддержки разработчикам следует перейти на новые метрики "Просмотр медиафайла" и "Зрители медиафайла", которые заменят устаревшие метрики "Показы", "Охват" и "Зрители".

Что изменится?

Следующие метрики будут упразднены для всех версий API в июне 2026 года. Рекомендуем разработчикам проверять актуальную информацию в журнале изменений Graph API.

Охват публикации или Страницы"

• GET {page-id}/insights/page_impressions_unique*
• GET {page-id}/insights/page_impressions_paid_unique*
• GET {page-id}/insights/page_impressions_viral_unique*
• GET {page-id}/insights/page_impressions_nonviral_unique*
• GET {page-id}/insights/page_posts_impressions*
• GET {page-id}/insights/page_posts_impressions_unique*
• GET {page-id}/insights/page_posts_impressions_paid*
• GET {page-id}/insights/page_posts_impressions_paid_unique*
• GET {page-id}/insights/page_posts_impressions_organic_unique*
• GET {page-id}/insights/page_posts_served_impressions_organic_unique*
• GET {page-id}/insights/page_posts_impressions_viral*
• GET {page-id}/insights/page_posts_impressions_viral_unique*
• GET {page-id}/insights/page_posts_impressions_nonviral*
• GET {page-id}/insights/page_posts_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_unique*
• GET {post-id}/insights/post_impressions_paid_unique*
• GET {post-id}/insights/post_impressions_fan_unique*
• GET {post-id}/insights/post_impressions_organic_unique*
• GET {post-id}/insights/post_impressions_viral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*

Показы видео

• GET {video-id}/video_insights/post_impressions_unique
• GET {video-id}/video_insights/total_video_impressions
• GET {video-id}/video_insights/total_video_impressions_unique
• GET {video-id}/video_insights/total_video_impressions_paid_unique
• GET {video-id}/video_insights/total_video_impressions_paid
• GET {video-id}/video_insights/total_video_impressions_organic_unique
• GET {video-id}/video_insights/total_video_impressions_organic
• GET {video-id}/video_insights/total_video_impressions_viral_unique
• GET {video-id}/video_insights/total_video_impressions_viral
• GET {video-id}/video_insights/total_video_impressions_fan_unique
• GET {video-id}/video_insights/total_video_impressions_fan
• GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
• GET {video-id}/video_insights/total_video_impressions_fan_paid

Показы истории

• Две метрики будут заменены
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

Мы рекомендуем использовать следующие метрики:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Для разбивок по оплаченному и органическому охвату рекомендуем использовать следующие метрики, которые предоставляют схожую статистику:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Graph API: прекращение поддержки метрик 3-секундных просмотров

В июне 2026 года мы планируем прекратить поддержку метрик, связанных с 3-секундными просмотрами. Эти метрики устарели и больше не показываются в наших инструментах статистики, однако всё ещё были доступны через Graph API.

Чтобы привести наши продукты и API к единому набору метрик, а также повысить общую надежность системы, мы прекращаем поддержку устаревших метрик. После прекращения поддержки разработчикам следует перейти на новые метрики "Просмотр медиафайла" и "Зрители медиафайла", которые заменят устаревшие метрики "Показы", "Охват" и "Зрители".

Что изменится?

Следующие метрики будут упразднены для всех версий API в июне 2026 года. Рекомендуем разработчикам проверять актуальную информацию в журнале изменений Graph API.

• GET {page-id}/insights/page_video_views_unique
• GET {post-id}/insights/post_video_views_organic_unique
• GET {post-id}/insights/post_video_views_paid_unique
• GET {post-id}/insights/post_video_views_unique
• GET {video-id}/video_insights/total_video_views_organic_unique
• GET {video-id}/video_insights/total_video_views_paid_unique
• GET {video-id}/video_insights/total_video_views_unique

Мы рекомендуем использовать следующие метрики:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Для разбивок по оплаченным и органическим 3-секундным просмотрам рекомендуем использовать следующие метрики, которые предоставляют схожую статистику:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Marketing API: прекращение поддержки торговых кампаний Advantage+ и кампаний Advantage+ с использованием каталога (ASC и AAC)

Унификация автоматизации устанавливает оптимальную настройку Advantage+ как настройку по умолчанию для кампаний с целями "Продажи" и "Лиды", а также кампании Advantage+ для приложения. Так рекламодатели и партнеры получат упрощенный доступ к новым и высокопроизводительным продуктам Meta для автоматизации. Мы постепенно прекращаем поддержку устаревших API и переходим на новую унификацию автоматизации, настройку Advantage+ для разработчиков Marketing API.

Начиная с версии 25.0 (18 февраля 2026 года) кампании ASC и AAC больше нельзя будет создавать или обновлять с помощью Marketing API. Спустя 90 дней (19 мая 2026 года) это изменение затронет все версии MAPI.

В версии 26.0 (предположительно выйдет в сентябре 2026 года) все оставшиеся кампании ASC и AAC будут приостановлены.

Торговые кампании Advantage+ и кампании Advantage+ с использованием креатива Advantage+ с предельным бюджетом на существующих клиентов (ECBC) можно будет редактировать до момента выхода версии 26.0. Эта функция недоступна для кампаний Advantage+. Разработчикам, у которых есть кампании с ECBC, следует продублировать их с помощью одного из описанных ниже способов до момента выпуска версии 26.0:

• Продублировать вручную. Откройте существующую торговую кампанию Advantage+ или кампанию Advantage+ с использованием каталога в Ads Manager. Вы увидите предложение "Дублировать кампанию". Вы сможете создать новую кампанию с теми же настройками, что и существующая, в один клик.
• Воспроизвести кампании ECBC с помощью API, следуя инструкциям из документации для разработчиков по воспроизведению кампаний с помощью API, доступным по этой ссылке.
• Запросить массовый перенос на уровне рекламного аккаунта. Если вы управляемый партнер, мы можем организованно продублировать все ваши кампании ECBC в согласованный срок. Свяжитесь со своим контактным лицом в Meta и укажите ID аккаунтов и предпочитаемую дату переноса.

Примечание. При дублировании будут создаваться новые ID кампаний.

Это изменение повлияет на следующие конечные точки:

• POST /{campaign-id}
• POST /{campaign-id}/copies

Подробнее в обновленной документации для разработчиков и часто задаваемых вопросах.

Ссылка на документацию для разработчиков

• Документация для разработчиков: кампании с целями "Продажи" и "Лиды", а также кампании Advantage+ для приложения

Ссылка на справочную статью по функции

• Справочный центр — кампании Advantage+
• Справочный центр — особые категории рекламы

Упраздненные версии API:

Обратите внимание на приведенные ниже прекращения поддержки в рамках графика управления версиями Graph API и Marketing API для Facebook.

Graph API

• 21 мая 2026 года будет упразднена и удалена с платформы версия Graph API 19.
• 24 сентября 2026 года будет упразднена и удалена с платформы версия Graph API 20.

Чтобы избежать перебоев в работе, рекомендуем перенести все вызовы на новую версию API, которая была запущена сегодня.