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

23 января 2024 г.Автор:Mohamed Amr Abouelhassan

Подписаться на блог "Новости для разработчиков"

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

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

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

Теперь детальный таргетинг Advantage доступен для всех целей кампании и видов оптимизации

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

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

23 января 2024 года мы выпускаем следующие изменения для рекламодателей и партнеров, использующих Marketing API:

Если кампания оптимизируется для показов, просмотров видео, охвата вовлеченности или прироста запоминаемости рекламы, то рекламодатель сможет включить детальный таргетинг Advantage.
В кампаниях с оптимизацией для лидов детальный таргетинг Advantage будет включен автоматически, однако его можно выключить.
- Примечание. Эта функция будет включена автоматически для новых и дублированных кампаний/групп объявлений, но ее можно деактивировать с помощью переключателя.
В кампаниях, оптимизируемых для кликов по ссылке или просмотров целевой страницы, детальный таргетинг Advantage будет включен автоматически и его нельзя выключить.

Рекламодателей и партнеров, использующих Marketing API, ожидают серьезные изменения. С 23 января 2024 года разработчики могут начать менять код. До 22 апреля 2024 года необходимо внедрить все обновления. Это изменение будет реализовано в API версии 19.

<Impacted endpoints>

Тип запроса	Конечная точка	Изменения
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	Поле targeting_optimization не будет приниматься для кампаний, оптимизируемых для кликов по ссылке и просмотров целевой страницы. Это также касается предыдущих видов оптимизации с детальным таргетингом Advantage, где его нельзя было выключить (оптимизации для конверсий, ценности, переписок, установок приложения и событий в приложении). В поле targeting_as_signal для кампаний, оптимизируемых для показов, просмотров видео, лидов, охвата, вовлеченности или прироста узнаваемости рекламы, значение должно быть null или 0, иначе возникнет ошибка.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	Поле targeting_optimization не будет приниматься для кампаний, оптимизируемых для кликов по ссылке и просмотров целевой страницы. Это также касается предыдущих оптимизаций с детальным таргетингом Advantage, где его нельзя было выключить (оптимизации для конверсий, ценности, переписок, установок приложения и событий в приложении). Для всех видов оптимизации, для которых включен детальный таргетинг Advantage без возможности его выключить, в поле targeting_as_signal будет автоматически выставлено значение 1 или 3 (в зависимости от комбинации цели и вида оптимизации).

Тип запроса

Конечная точка

Изменения

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

Поле targeting_optimization не будет приниматься для кампаний, оптимизируемых для кликов по ссылке и просмотров целевой страницы. Это также касается предыдущих видов оптимизации с детальным таргетингом Advantage, где его нельзя было выключить (оптимизации для конверсий, ценности, переписок, установок приложения и событий в приложении).
В поле targeting_as_signal для кампаний, оптимизируемых для показов, просмотров видео, лидов, охвата, вовлеченности или прироста узнаваемости рекламы, значение должно быть null или 0, иначе возникнет ошибка.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

Поле targeting_optimization не будет приниматься для кампаний, оптимизируемых для кликов по ссылке и просмотров целевой страницы. Это также касается предыдущих оптимизаций с детальным таргетингом Advantage, где его нельзя было выключить (оптимизации для конверсий, ценности, переписок, установок приложения и событий в приложении).
Для всех видов оптимизации, для которых включен детальный таргетинг Advantage без возможности его выключить, в поле targeting_as_signal будет автоматически выставлено значение 1 или 3 (в зависимости от комбинации цели и вида оптимизации).

Marketing API: новые объявления, группы объявлений и кампании со старыми целями

Начиная с Marketing API 19.0 больше нельзя создавать новые объявления, группы объявлений и кампании со старыми целями (перечислены ниже) путем копирования рекламы. Необходимо будет обновить цели рекламы согласно новой структуре.

Начиная с Marketing API версии 20 больше будет нельзя создавать объявления и группы объявлений в кампаниях со старыми целями. Однако это можно делать в более ранних версиях API (например, 19 и 18). Сейчас от вас не требуется действий в отношении существующей рекламы со старыми целями.

Затронутые старые цели

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

Затронутые конечные точки POST

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

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

Часто задаваемые вопросы

Требует ли это изменение обновления кода?

Да. Многие вызовы API в версии 18 не будут работать в версии 19. Так, нельзя будет создавать новые объявления, группы объявлений и кампании со старыми целями путем копирования рекламы.

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

Раньше вызовы API для дублирования объявления, группы объявлений или кампании со старыми целями проходили успешно, однако теперь их будет нельзя выполнить.

В какие сроки необходимо внедрить изменения в коде?

Это нужно сделать до прекращения поддержки версии 18, предварительно до сентября 2024 года.

Дополнительная документация для разработчиков

Справочные статьи

Разрешение доступа к общедоступному контенту Страницы

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

Представляем API для аудитории Advantage+

В октябре прошлого года мы запустили аудиторию Advantage+ — новый упрощенный способ создания аудиторий, позволяющий увеличить результативность кампаний. Для этого реклама показывается более широкой аудитории, однако при этом охватываются люди, в которых заинтересован рекламодатель.

В ближайшее время мы выпустим аудиторию Advantage+ в Marketing API.

Чтобы включить эту функцию, установите для параметра targeting_automation в advantage_audience значение 1.
Чтобы выключить эту функцию, установите для параметра targeting_automation в advantage_audience значение 0.

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

Упразднение Facebook Groups API

Мы упраздняем Facebook Groups API в версии 19. Через 90 дней этот инструмент будет удален из всех версий. Также будут упразднены все разрешения (publish_to_groups, groups_access_member_info) и функции проверки (Groups API), связанные с Facebook Groups API.

Основным сценарием использования Groups API выступали личные ответы в группах. В версии 19 мы выпускаем новое изменение, которое будет активировать этот сценарий использования, не требуя от разработчиков использовать Groups API. Большинству разработчиков, применяющих личные ответы, не потребуется вносить изменения в версии 19. Если разработчик полагался на вызовы в конечных точках публикаций групп через Groups API после получения webhook личных ответов, ему нужно использовать маркер доступа к Странице для этих запросов.

Разработчики могут проверить, используют ли конечные точки упраздненные разрешения, протестировав их в версии 19.0.

Изменения в Page Insights API: прекращение поддержки метрик

Страницы Facebook переходят на новую версию, поэтому мы прекратим поддержку нескольких метрик в Page Insights API. Подробнее.

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

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

Graph API

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

Marketing API

6 февраля 2024 г. будет упразднена и удалена с платформы версия Marketing API 16.0.
14 мая 2024 г. будет упразднена и удалена с платформы версия Marketing API 17.0.

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

Meta Business SDK

Выпуск Meta Business SDK версии 19

Мы представим Meta Business SDK версии 19 сразу после выпуска Graph API 19. В этот выпуск войдут исправления ошибок, обновление зависимости, новые функции и, что наиболее важно, обновленный интерфейс API в соответствии с Graph API 19. В будущем мы планируем чаще выпускать обновления SDK для соответствия текущим версиям API. Это позволит разработчикам использовать последние версии API, функции и решения.

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