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

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

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

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

Объединение параметров статуса местоположения аудиторий для таргетинга по местоположению

В мае 2023 года мы объединили статус местоположения аудитории с параметром Люди, которые живут в этом месте или недавно здесь были (сейчас он выбирается по умолчанию при настройке аудитории для таргетинга по местоположению). В этом обновлении мы объединим другие ранее доступные параметры и удалим вариант Люди, которые живут в этом месте или недавно здесь были.

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

Это обновление будет применяться к новым и дублированным кампаниям. Настройки существующих кампаний, созданных до запуска обновления, не изменятся (если вы их не дублируете и если они не находятся в статусе черновика).

Добавление параметров add_security_recommendation и code_expiration_minutes в WA Message Templates API

Ранее в этом году мы выпустили решение для аутентификации в WhatsApp, которое позволяет создавать и отправлять шаблоны для аутентификации с нативными кнопками и предустановленными сообщениями. С выпуском Graph API 18 мы вносим улучшения в процесс получения шаблонов для аутентификации, комплексно упрощая работу с ними для поставщиков бизнес-услуг и компаний.

Используя Graph API 18, поставщики бизнес-услуг и компании смогут эффективнее управлять контентом в созданных ими предустановленных сообщениях для аутентификации. В частности, полезные данные будут возвращать параметры предустановленной конфигурации контента в дополнение к тексту, используемому WhatsApp. Это улучшение позволит поставщикам бизнес-услуг и компаниям создавать интерфейсы редактирования для шаблонов для аутентификации, которые можно добавить к API.

Обратите внимание, что при переходе на Graph API 18 могут возникать ошибки в случае, если поставщики бизнес-услуг или компании берут полный ответ из запроса GET и отправляют его обратно через запрос POST для обновления шаблонов. Чтобы устранить такую проблему, основной текст, заголовок и колонтитул нужно опустить перед обратной передачей запроса API.

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

• Место размещения Facebook Reels для рекламы с номером телефона
  Meta запускает возможность показывать рекламу с номером телефона на платформе Facebook Reels. Реклама с номером телефона позволяет пользователям звонить компании на этапе рассмотрения, когда они видят объявление. Благодаря этому компания может вступать с потенциальными клиентами в расширенный диалог. Компания может показывать рекламу с номером телефона людям на основе их поведения в реальном времени на Facebook. На уровне группы объявлений в Ads Manager компания может добавить место размещения Facebook Reels.
• Повторный запуск рекламы с номером телефона через API
  12 сентября 2023 года мы выпускаем обновленное руководство по созданию рекламы с номером телефона через API. Мы представляем документацию именно по рекламе с номером телефона, чтобы помочь сторонним разработчикам создавать кампании с такими объявлениями и анализировать статистику по ним, в том числе метрики, связанные со звонками. В будущем мы планируем добавить поддержку дополнений для звонков на нашей платформе API. Для создания рекламы с номером телефона через платформу API разработчикам требуется доступ к общим разрешениям для создания объявлений.
  
  Дополнительная информация доступна в документации для разработчиков.

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

Изменения Graph API для функции конкретных разрешений для пользователей

Мы обновляем две конечные точки Graph API для аккаунтов WhatsApp Business. Это следующие конечные точки:

• Получение шаблонов сообщений, связанных с аккаунтом WhatsApp Business.
• Получение номеров телефона, связанных с аккаунтом WhatsApp Business.

В версии 18 мы выпускаем новую функцию — конкретные разрешения для пользователей. Все существующие пользователи, уже добавленные в аккаунт WhatsApp Business, будут заполнены и сохранят доступ (обновление на них не повлияет).

Администратор сможет вносить изменения в разрешения. Если администратор изменит разрешение и удалит доступ к просмотру шаблонов сообщений или номеров телефона для одного из пользователей, то этот конкретный пользователь в версии 18 и более ранних будет видеть соответствующее сообщение об ошибке.

Упразднение устаревших названий метрик для объектов IG Media и IG User

С 12 сентября для Instagram будут удалены дублирующиеся и устаревшие статистические метрики из Instagram Graph API. Это нужно для того, чтобы предоставить нашим разработчикам единый источник метрик.

С этим обновлением наша отчетность станет понятнее и качественнее.

Через 90 дней после запуска этого проекта (например, 11 декабря 2023 года) мы удалим все дублирующиеся и устаревшие статистические метрики из всех версий Instagram Graph API, чтобы согласовать это решение с приложением Instagram.

Мы ценим все отзывы нашего сообщества разработчиков и надеемся на дальнейшее сотрудничество.

Чтобы узнать больше, ознакомьтесь с документацией для разработчиков по объектам IG Media и IG User.

Упразднение всех конечных точек Facebook Wi-Fi версий 1 и 2

Решение Facebook Wi-Fi создавалось для улучшения процесса подключения к точкам доступа Wi-Fi в компаниях. Оно позволяло клиентам с легкостью подключаться к бесплатной сети Wi-Fi, отмечая свое посещение компании на Facebook. Оно также позволяло продавцам контролировать то, кто и как долго может пользоваться их сетью Wi-Fi, а также интегрировалось с рекламой для обеспечения таргетинга на людей, которые пользовались Wi-Fi компании. Этот продукт был упразднен 12 июня 2023 года. Период уведомления партнеров завершился, и теперь все конечные точки, использовавшиеся Facebook Wi-Fi версий 1 и 2, упразднены и удалены.

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

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

Graph API

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

Marketing API

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

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

SDK Платформы Facebook

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

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