Introducing Graph API v22.0 and Marketing API v22.0
Сегодня мы выпускаем Graph API 22.0 и Marketing API 22.0. Ниже перечислены изменения, которые, по нашему мнению, наиболее важны для сообщества разработчиков. К ним относятся объявления, информация об обновлении продуктов и уведомления о прекращении поддержки интеграции некоторых приложений с нашей платформой.
Полный список изменений и подробные сведения о них доступны в журнале.
Общие обновления
Изменения в Marketing API 22 относительно применения пользовательских аудиторий на основе списков клиентов в кампаниях по продвижению жилья, трудоустройства, а также финансовых продуктов и услуг, в том числе кредитов
Касаются версии 22.0+ и будут распространены на остальные в марте 2025 года
Определенные пользовательские аудитории на основе списков клиентов станут недоступны для использования в кампаниях по продвижению жилья, трудоустройства, а также финансовых продуктов и услуг, в том числе кредитов. Узнать больше об обновлении и том, распространяются ли на вас эти ограничения, можно здесь. Кроме того, на уровне группы объявлений будет добавлено поле is_sac_cfca_terms_certified (см. пример). Вам потребуется задействовать это поле для подтверждения того, что все пользовательские аудитории на основе списков клиентов, применяемые в группе объявлений в рамках кампаний по продвижению жилья, трудоустройства, а также финансовых продуктов и услуг, в том числе кредитов, соответствуют требованиям сертификации Meta для таких аудиторий. Начало апреля 2025 года: если в существующих кампаниях и группах объявлений применяются пользовательские аудитории на основе списков клиентов, которые не соответствуют требованиям, показ рекламы может быть приостановлен. В таком случае вы увидите ошибки с инструкциями по их устранению в Ads Manager и Marketing API.
Изменения затронут следующие конечные точки:
Custom Audience API 22
С 6 января 2025 года вы можете использовать новое поле is_eligible_for_sac_campaigns, чтобы определять, можно ли применить пользовательскую аудиторию в группах объявлений в рамках кампаний из особой категории рекламы. Укажите предполагаемые сведения в полях special_ad_categories и special_ad_category_countries кампании особой категории рекламы, в которой будет использоваться эта аудитория. Также заполните поле ad_account_id, чтобы указать аккаунт, который будет применять аудиторию для создания или редактирования группы объявлений.
Изменения затронут следующие конечные точки:
Охват людей, которым интересны выбранные вами города и регионы
Мы рады сообщить о запуске новой функции таргетинга по местоположению. Благодаря этой функции рекламодатели смогут повышать результативность посредством расширения охвата за пределы целевых городов и регионов. При этом наша система рекламы обеспечивает более гибкий подход к показу объявлений людям, проявившим интерес к определенному местоположению.
Эта функция расширяет существующие возможности таргетинга по местоположению и позволяет охватывать людей, которые показали намерение путешествовать и делать покупки или демонстрируют общий интерес к городам и регионам, на которые вы настроили таргетинг в пределах одной страны.
В ходе тестирования клиенты, использовавшие новую функцию таргетинга по местоположению, снизили цену за результат на 6,7 %.
Узнать больше можно здесь.
Упраздненные элементы и важные изменения
Замена конечных точек Instagram User, Instagram Media, Instagram Carousel и Instagram Comment на IG User, IG Media и IG Comment
Мы вносим изменения в Instagram Graph API и Marketing API, чтобы разработчикам было проще создавать решения для компаний. Вместо объектов Instagram User, Instagram Media, Instagram Carousel и Instagram Comment в Graph API 22 теперь применяются следующие: IG User и IG Media, в том числе Carousels и IG Comment. Мы также расширили функционал этих объектов, чтобы обеспечить равноценное использование в большинстве случаев.
Разработчики должны внести изменения в процесс использования затронутых конечных точек Marketing API до 21 января 2026 года, а Graph API — до 21 апреля 2025 года. Если в своих вызовах API вы обновляете версии Graph API автоматически, обязательно ознакомьтесь с этими изменениями. Для разработчиков, использующих Graph API 22, обновления применяются сразу же.
Узнать больше, в том числе об обновляемых конечных точках, неподдерживаемых сценариях использования и сроках внедрения изменений, можно в блоге для разработчиков.
Прекращение поддержки исключений для детального таргетинга
Мы стремимся помогать рекламодателям в повышении результативности, поэтому прекращаем поддержку исключений для детального таргетинга. У вас останется возможность исключать своих работодателей с помощью настроек ограничения аудитории на уровне аккаунта. Подробнее.
Мы считаем, что эти изменения помогут повысить результативность кампаний. Согласно результатам тестирования среди рекламодателей медианная цена за конверсию оказалась на 22,6 % ниже без использования исключений для детального таргетинга, чем с ними.
В результате этого изменения пользовательские аудитории в поле исключений будут упразднены. Вы по-прежнему можете задавать исключения для пользовательских аудиторий в поле excluded_custom_audiences.
С 21 января 2025 года разработчики могут начать менять код. Завершить этот процесс необходимо до 21 апреля 2025 года. Это изменение будет реализовано в версии 22. Посмотреть список затронутых конечных точек можно в блоге для разработчиков.
Упразднение пакета стандартных улучшений в Marketing API
Влияние Marketing API 22.0 на улучшения креатива Advantage+
Новая версия Marketing API больше не будет поддерживать пакет стандартных улучшений креатива Advantage+. Вместо этого появится возможность включить индивидуальные улучшения креатива. Подробнее о креативе Advantage+.
Ознакомиться с дополнительной информацией для разработчиков можно тут, а с документацией для разработчиков — тут.
Конечные точки, которые перестанут поддерживать стандартные улучшения:
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
Внедрение метрики Instagram Views и упразднение метрик для показов и воспроизведений
Чтобы функции Instagram API ещё больше соответствовали приложению Instagram, мы вводим метрику 'views' для статистики по медиаконтенту и пользователям во всех версиях API. В рамках статистики по медиаконтенту для объектов "Лента", "История" и "Видео Reels" будет регистрироваться количество просмотров. В рамках статистики по пользователям API будет поддерживать метрику 'views' и разбивки по типу подписчиков и медиаконтента.
Начиная с версии 22, также будут упразднены следующие метрики:
- plays (статистика по медиаконтенту) — количество раз, когда видео Reels начинало воспроизводиться после зарегистрированного показа.
- clips_replays_count (статистика по медиаконтенту) — количество раз, когда видео Reels начинало повторно воспроизводиться после первичного воспроизведения. Повторным считается воспроизведение видео в течение не менее 1 мс в одном сеансе просмотра видео Reels.
- ig_reels_aggregated_all_plays_count (статистика по медиаконтенту) — количество раз, когда видео Reels начинало впервые или повторно воспроизводиться после зарегистрированного показа.
- impressions (статистика по медиаконтенту и пользователям) — общее количество просмотров объекта Instagram Media.
Исключение составляет метрика impressions для медиаконтента, поддержка которой прекратится только для матери��лов, созданных после 2 июля 2024 года включительно. Для медиаконтента, созданного до этой даты, API продолжит регистрировать значения в обычном режиме во всех версиях.
Узнать больше можно в документации для разработчиков относительно статистики по пользователям и медиаконтенту в Instagram. Чтобы избежать проблем, разработчики должны внести изменения до 21 апреля 2025 года.
Meta Business SDK
Выпуск Meta Business SDK 22
Meta Business SDK 22 будет выпущен вскоре после Graph API 22. В этот выпуск войдут исправления ошибок, обновление зависимости, новые функции и, что наиболее важно, обновленный интерфейс API в соответствии с Graph API 22.
Обратите внимание на предстоящие упразднения и прекращение поддержки в рамках нашего двухлетнего графика упразднения SDK платформы.
- В мае 2025 года будут упразднены версии SDK платформы Facebook 17.0 и более ранние.
Упраздненные версии API
Обратите внимание на приведенные ниже упразднения в рамках графика управления версиями Graph API и Marketing API для Facebook.
Graph API
- 14 мая 2025 года будет упразднена и удалена с платформы версия Graph API 16.
- 12 сентября 2025 года будет упразднена и удалена с платформы версия Graph API 17.
Marketing API
- 4 февраля 2025 года будет упразднена и удалена с платформы версия Marketing API 19.
- 6 мая 2025 года будет упразднена и удалена с платформы версия Marketing API 20.
Чтобы избежать перебоев в работе, рекомендуем перенести все вызовы на новую версию API, которая была запущена сегодня.
Обновления Page Insights API
