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

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

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

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

Ответы с сообщениями об ошибках на платформе WhatsApp Business

В рамках постоянного улучшения работы API и ответов на ошибки мы внесли некоторые изменения.

• Поддержка подкодов ошибок, которые редко используются и не являются надежным источником сведений, в ответах на ошибки в версии 16.0 и более поздних прекращена. Используйте вместо них поля code и details.
• Код ошибки 100 ("code":100) имел несколько уникальных заголовков, описывающих причину ошибки 100. Теперь все ошибки 100 используют в качестве заголовка Invalid Parameter. Прежние заголовки, описывающие природу ошибки, перенесены в свойство details. Это изменение также касается полезных данных Webhooks, описывающих ответ на ошибку 100.
• Объекты ошибок Webhooks получили новое свойство message, которое сопоставляется с одноименным свойством в полезных нагрузках ответов на ошибки API.

Платформа для разработчиков: подтверждение компании для расширенного доступа к любым API

Как сообщалось ранее (1 февраля 2023 г.), теперь, чтобы получить расширенный доступ для любых разрешений на платформе Meta for Developers, разработчики должны подтвердить свою компанию. Это позволит нам убедиться, что мы имеем дело с реальной компанией или организацией.

Для приложений, созданных после 1 февраля 2023 г., мы начнем требовать это постепенно, когда новые приложения будут запрашивать расширенный доступ. Приложения с расширенным доступом, созданные до 1 февраля 2023 г., нужно будет связать с подтвержденной компанией начиная с 1 мая 2023 г. Список разрешений, для расширенного доступа к которым нужно пройти подтверждение компании, см. на этой странице.

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

Упразднение функции "Возможное путешествие"

В 2018 году мы запустили функцию "Возможное путешествие" — переключатель, который рекламодатели могут использовать для показа рекламы с приоритетом людям, которые выразили намерение отправиться в путешествие, но ещё не решили, куда именно. Функция возможного путешествия работала в сочетании с существующими параметрами таргетинга и помогала рекламодателям показывать рекламу нужным людям в нужное время в Facebook, Instagram и Audience Network. За последние четыре года мы постоянно совершенствовали свои системы машинного обучения и проводили обширные тестирования. Теперь мы можем помогать рекламодателям в сфере туризма охватывать потребителей, которые планируют путешествия, и достигать аналогичных целей по результативности без использования переключателя.

Со 2 февраля 2023 г. переключатель "Возможное путешествие" больше не доступен для новых кампаний в Ads Manager и API. Мы определили, что рекламодатели могут достигать той же результативности, не используя этот переключатель. Его использование никак не оказывает значимого влияния на результативность кампании.

По мере совершенствования моделей машинного обучения достичь тех же целей и результативности можно и без этого переключателя, поэтому мы считаем, что его удаление обеспечит лучший опыт при настройке кампании.

Упразднение рекламы авиарейсов для привлечения клиентов

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

Если в настоящий момент вы или ваши партнеры используете рекламу авиарейсов для привлечения клиентов, мы рекомендуем завершить такие кампании до 1 мая 2023 г.

Упразднение размещения рекламы в моментальных статьях

С 20 апреля 2023 г. прекращается поддержка моментальных статей и размещения рекламы в них. Моментальные статьи появились в 2015 году и позволили многим авторам создавать интерактивные статьи с медиафайлами на мобильных устройствах, а также монетизировать их с помощью рекламы на Facebook. Однако большинство пользователей Facebook практически не обращаются к платформе для поиска новостей и предпочли бы видеть меньше такого контента в Ленте. В связи с этим мы корректируем направление своих инвестиций, чтобы они в большей степени соответствовали предпочтениям пользователей.

С 20 апреля 2023 г. размещение рекламы в моментальных статьях при создании кампании в Ads Manager и API Marketing станет недоступно. Все группы объявлений, которые размещались только в моментальных статьях, будут приостановлены. Группы объявлений, где моментальные статьи были одним из мест размещений, будут обновлены, а моментальные статьи будут удалены из списка мест размещения.

Скрытые реакции, комментарии и теги в контенте, опубликованном в профилях пользователей

В этом выпуске мы реализуем изменение, в результате которого комментарии, реакции и теги пользователя сеанса будут скрыты. Поля via и sharedposts будут возвращать пустой набор данных для публикаций в профилях пользователей. Это изменение коснется только контента, опубликованного в профилях пользователей.

Прекращение поддержки версий TLS старше 1.2

Чтобы повысить уровень безопасности, мы прекращаем поддержку API Graph для версий TLS старше 1.2. Поддержка статических шифров RSA (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) в TLS версии 1.2 также будет прекращена. Через 90 дней в ответ на запросы API, отправленные с использованием устаревших версий TLS, будет возвращаться ошибка.

Кроме того, после 1 мая 2023 г. сетевой трафик на developer.facebook.com из браузеров, использующих устаревшие версии TLS (версии старше 1.2 и TLS версии 1.2 со статическими шифрами RSA [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA]), будет отклоняться.

Категории шаблонов в WhatsApp

В прошлом году мы обновили категории шаблонов в WhatsApp Manager и API, чтобы собрать статистику по сценариям использования шаблонов на платформе WhatsApp Business. Со 2 февраля 2023 г. названия шаблонов изменены, чтобы наилучшим образом соответствовать этим сценариям использования.

• Шаблоны с маркетинговыми сообщениями остаются в категории Маркетинг без изменений.
• Шаблоны с транзакциями теперь относятся к категории Услуги.
• Шаблоны с кнопкой одноразового пароля теперь относятся к категории Аутентификация.

При создании и изменении шаблонов с помощью Graph версии 16 компании должны использовать обновленные категории шаблонов. Изменения вступят в силу для всех версий с 1 мая. Новые категории нужно будет использовать при создании или редактировании шаблонов в любой версии. Чтобы у компаний и поставщиков бизнес-решений не возникало перебоев при создании или редактировании шаблонов, вызовы API следует перевести на использование значений и шаблонов новых категорий не позднее 1 мая 2023 года.

Другие важные даты и примечания:

• Перенос категорий шаблонов. 1 апреля все существующие шаблоны WhatsApp будут перенесены и получат новые категории. Компании могут следить за категоризацией шаблонов в WhatsApp Manager и смогут проверить их до 15 мая. Если компания не согласна с назначенной категорией, она может обжаловать ее до 15 мая. Все шаблоны, созданные или измененные с 1 апреля по 1 мая с помощью API Graph версии 15 и более поздних, будут перенесены 5 мая. В связи с этим мы рекомендуем с 1 апреля использовать для создания шаблонов версию 16. С 1 мая во всех шаблонах, созданных в WhatsApp Manager или любой версии API Graph, будут использоваться новые категории шаблонов.
• Создание шаблонов с новыми категориями. С 1 апреля для всех шаблонов, созданных в API Graph и WhatsApp Manager, требуется проверка и одобрение категории. Любой новый или измененный шаблон может быть отклонен, если WhatsApp обнаружит, что для него выбрана неправильная категория. В причине отклонения будет указано, что выбранная категория не соответствует контенту шаблона согласно правилам. Компании могут изменить категорию и повторно отправить шаблон на проверку, изменить шаблон или обжаловать решение. С 1 мая для новых шаблонов, содержащих переменные, необходимо будет предоставить примеры их значений. С 1 июня плата с компаний будет взиматься в соответствии с новыми таблицами тарифов по категориям.

API платформы Messenger

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

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

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

API Graph

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

API Marketing

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

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

SDK Платформы Facebook

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

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