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

Сегодня мы выпускаем API Graph 17.0 и API Marketing 17.0 для Facebook. Ниже перечислены изменения, которые, по нашему мнению, наиболее важны для нашего сообщества разработчиков. К ним относятся объявления, информация об обновлении продуктов и уведомления об упразднениях, которые могут повлиять на интеграцию ваших приложений с нашей платформой.

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

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

Упразднен продукт "Рекламные стратегии"

Бета-версия продукта "Рекламные стратегии" была упразднена 28 октября 2022 г. В связи с этим в API Marketing 17.0 мы упразднили поля ad_strategy_id и ad_strategy_group_id для конечной точки campaigns.

Упразднен API Offline Conversions

В феврале 2023 г. в API Conversions была добавлена полная поддержка офлайн-событий, и по возможностям он стал сравним с текущей конечной точкой API Offline Conversions. Объединив API для веб- и офлайн событий в единый API, мы надеемся упростить и улучшить использование рекламодателями своих кросс-канальных маркетинговых данных для оптимизации рекламы, расширения пользовательских аудиторий и повышения эффективности измерений.

Начиная с API Graph версии 17, выпущенной 23 мая 2023 г., API Offline Conversions больше не будет поддерживать офлайн-события. Мы рекомендуем рекламодателям, интеграции которых сейчас используют API Offline Conversions, перевести их на работу с API Conversions и не обновлять API Offline Conversions до завершения перехода.

Упразднен устаревший процесс создания целей

В декабре 2021 г. мы объявили об изменении процесса выбора целей при создании кампаний. Новый процесс помогает рекламодателям настроить кампанию так, чтобы эффективно добиться поставленных целей. Внедрение нового процесса для рекламы, нацеленной на результат, привело к изменениям в API Marketing.

Упразднение устаревшего процесса и целей начнется с выпуском API Marketing 17.0. В API Marketing 17.0 при создании кампаний можно будет выбирать только цели для рекламы, ориентированной на результат. Устаревшие API целей будут упразднены. Изменения не затронут существующие кампании с устаревшими целями и копии таких кампаний. Они по-прежнему будут поддерживаться в этой версии. Подробнее читайте в недавней записи в блоге для разработчиков.

Обязательное поле для стандартных улучшений креативов Advantage+

Ранее в этом году мы выпустили стандартные улучшения креативов Advantage+ для API Marketing. Начиная с 23 мая 2023 г. пользователи API Marketing должны будут указывать, зарегистрировано ли объявление в стандартных улучшения креативов Advantage+, указывая значение OPT_IN или OPT_OUT в поле enroll_status. Если оставить это поле пустым, пользователь получит сообщение об ошибке и будет направлен к заполнению поля. Подробнее о стандартных улучшениях креативов Advantage+ для API Marketing читайте в этой записи в блоге для разработчиков.

Изменение затронет следующие конечные точки:

• POST /{ad-account-id}/adcreatives;
• POST /{ad-account-id}/ads.

Упразднены объявления из каталога Advantage+ для стриминговых платформ

С выходом API Marketing API 17.0 мы прекращаем использование объявлений из каталога Advantage+ для стриминговых платформ. В качестве альтернативы рекомендуем использовать объявления из коммерческого каталога. Здесь вы найдете руководство по настройке коммерческого каталога. Будут упразднены следующие конечные точки:

• создание каталога Advantage+ для стриминговых платформ: граница контекста owned_product_catalogs с вертикалью media_titles;.
• загрузка лент с названиями медиафайлов: граница контекста product_feeds для каталога Advantage+ для стриминговых платформ;
• создание элемента названия медиафайла: граница контекста media_titles для каталога Advantage+ для стриминговых платформ;
• создание кампании с помощью каталога Advantage+ для стриминговых платформ: граница контекста campaigns с каталогом DAS на уровне L3, L2 или L1.

21 августа 2023 г. вышеуказанные изменения будут применены ко всем версиям API Marketing. Мы приостановим все кампании, которые имеют каталоги Advantage+ для стриминговых платформ, подключенные на уровне L3, L2 или L1.

Упразднен API Instant Articles

Поскольку продукт Моментальные статьи был упразднен 20 апреля 2023 г., мы упраздняем API, позволявший издателям управлять моментальными статьями.

Использование разрешения на управление компанией для аккаунтов пользователей

Ранее дополнительные страницы, администрируемые компанией, возвращались без разрешения business_management. Начиная с 23 мая 2023 г. для доступа к администрируемым компанией страницам потребуется разрешение business_management. Подробнее об этом разрешении читайте на странице business_management.

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

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

API Graph

• 8 июня 2023 г. будет упразднена и удалена с платформы версия API Graph 10.0.
• 14 сентября 2023 г. будет упразднена и удалена с платформы версия API Graph 11.0.
• 8 февраля 2024 г. будет упразднена и удалена с платформы версия API Graph 12.0.

API Marketing

• 15 августа 2023 г. будет упразднена и удалена с платформы версия API Marketing 14.0.
• 15 августа 2023 г. будет упразднена и удалена с платформы версия API Marketing 15.0.

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

SDK Платформы Facebook

Обратите внимание на предстоящие упразднения и прекращение поддержки в рамках нашего 2-летнего графика упразднения SDK платформы:

• в июне 2023 г. прекращается поддержка SDK Платформы Facebook версии 9.0 и более ранних;
• в октябре 2023 г. прекращается поддержка SDK Платформы Facebook версии 11.0 и более ранних;
• в феврале 2024 г. прекращается поддержка SDK Платформы Facebook версии 12.0 и более ранних.