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

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

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

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

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

Чтобы упростить процесс создания кампании для рекламодателей, с выходом API Graph 15.0 для вновь создаваемых пользовательских конверсий будет требоваться хотя бы одно связанное правило. Пользовательские конверсии, для которых не требуются правила, должны использовать оптимизацию пользовательских событий, которая позволяет оптимизировать рекламные кампании непосредственно по пользовательскому событию. Мы активно работаем над преобразованием существующих пользовательских конверсий из единого универсального предложения в несколько продуктов, ориентированных на конкретные ценности, чтобы лучше соответствовать потребностям и сценариям использования наших рекламодателей. Это изменение будет способствовать переходу рекламодателей от конверсий на основе пользовательских событий к оптимизации пользовательских событий.

Обновления Условий использования платформы

Мы обновляем Условия использования платформы, связанные с тем, когда мы можем отзывать доступ приложения к любым API, разрешениям или функциям платформы, которые оно не использовало или не обращалось в течение определенного времени. С 15 декабря 2022 г. согласно Условиям использования платформы приложение будет считаться активным, только если оно демонстрировало активность за предшествующие 28 дней.

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

Чтобы ознакомиться со всеми изменениями, прочтите Условия использования платформы.

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

Новая пользовательская аудитория Advantage

С 19 сентября 2022 г. мы запускаем пользовательскую аудиторию Advantage. Пользовательская аудитория Advantage использует пользовательскую аудиторию рекламодателя, чтобы управлять показами и найти больше людей, которые с высокой вероятностью достигнут заявленной цели оптимизации. Это означает, что мы будем показывать рекламу за пределами их пользовательской аудитории, если это может повысить результативность. Пользовательская аудитория Advantage, в том числе детальный таргетинг Advantage и похожая аудитория Advantage, является частью нашего набора продуктов "Таргетинг Advantage". В продуктах таргетинга Advantage используются передовые технологии автоматизации и машинного обучения, которые помогают повысить результативность рекламных кампаний при меньшем объеме ручной работы.

Рекламодатели, использующие пользовательские аудитории, смогут выбирать пользовательские аудитории Advantage. С пользовательскими аудиториями Advantage рекламодатели по-прежнему будут создавать пользовательские аудитории (с сайта, по активности в приложении, по списку клиентов или на основе вовлеченности) и применять соответствующие включения и исключения, пользуясь при этом преимуществами нашей передовой технологии автоматизации и машинного обучения, которая использует вашу пользовательскую аудиторию в качестве источника для управления показами, чтобы охватить больше пользователей, которые с высокой вероятностью достигнут вашей цели оптимизации.

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

Упразднение аудиторий для рекламы особой категории

В рамках нашего соглашения с Министерством жилищного строительства и городского развития США (HUD) мы прекращаем действие аудиторий для рекламы особой категории — инструмента, позволяющего рекламодателям расширять аудиторию для рекламных объявлений, связанных с жильем, трудоустройством и кредитованием. С 15 сентября 2022 г. создавать аудитории для рекламы особой категории через API Marketing будет невозможно.

Для рекламодателей и партнеров блокировка создания новых аудиторий для рекламы особой категории 15 сентября 2022 г. станет серьезным изменением, так как предыдущие значения устареют. В 2019 г., помимо отмены некоторых вариантов таргетинга для объявлений о жилье, работе и кредитовании, мы ввели аудитории для рекламы особой категории в качестве альтернативы похожим аудиториям. Однако вопрос "равноправия" в машинном обучении быстро развивается, и аудитории для рекламы особой категории были одним из первых способов решения проблем. Теперь наше внимание переместится на новые подходы к обеспечению "равноправия", в том числе на объявленный ранее метод.

Ниже перечислены конечные точки, которые затронет это изменение.

Для считывания аудитории:

• конечная точка gr:get:AdAccount/customaudiences;
• поле operation_status.

Для создания наборов объявлений:

• конечная точка gr:post:AdAccount/adsets;
• поле subtype.

Для редактирования наборов объявлений:

• конечная точка gr:post:AdCampaign;
• поле subtype.

Для создания пользовательских аудиторий:

• конечная точка gr:post:AdAccount/customaudiences;
• поле subtype.

Для редактирования пользовательских аудиторий:

• конечная точка gr:post:CustomAudience.

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

Равноценность детального таргетинга Advantage и похожей аудитории Advantage

Этот проект обеспечивает равноценность детального таргетинга как сигнала (детальный таргетинг Advantage) для пользователей API, использующих наборы объявлений с целями "Сообщения" и "Установка приложения" (после выхода Ads Manager). Ранее мы запустили детальный таргетинг Advantage для API для наборов объявлений с целями "Конверсии" и целями оптимизации "Конверсии" и "Ценность" (наборы объявлений VO/OC).

В настоящее время, когда рекламодатели создают наборы объявлений через API с целями "Сообщения" или "Установка приложения", в качестве части критериев таргетинга (L2) передается два значения. Это список детального таргетинга (например, крикет, футбол, собаки и т. д.) и флаг, указывающий, хотят ли они выйти за пределы этих значений (детальный таргетинг Advantage). Если флаг установлен, наши системы показывают рекламу сверх выбора детального таргетинга, если это может повысить результативность. Если он не установлен, наши системы ограничивают показ только тем списком, который предоставили рекламодатели.

В дальнейшем (после выхода Ads Manager), когда рекламодатели будут создавать новые кампании с целями "Сообщения" и "Установка приложения", их списки детального таргетинга будут использоваться в качестве исходных данных (а не ограничений) для управления показом объявлений. В связи с этим мы отменяем флаг DTE для этих целей. Расширение таргетинга для списков детального таргетинга теперь будет действовать по умолчанию. При этом мы можем выходить за рамки списка детального таргетинга, если это может повысить результативность. Все остальные варианты выбора и исключения таргетинга затронуты не будут. Это изменение не распространяется на особые категории.

Принцип работы

Чтобы включить или отключить расширение детального таргетинга, ранее рекламодатели передавали флаг targeting_optimization со значением expansion_all или none. Учитывая изменения в семантике детального таргетинга для этих объявлений, рекламодателям не нужно передавать этот флаг при создании объявлений с целями "Сообщения" и "Установка приложения", поскольку он никак не повлияет на вновь созданные объявления. Все эти новые наборы объявлений всегда будут использовать списки детального таргетинга в качестве сигнала для наших внутренних систем, которые могут принять решение о показе объявлений за пределами этих наборов, если это означает лучшую результативность для рекламодателей.

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

• В связи с этим, если рекламодатели передают флаг targeting_optimization при создании новых наборов объявлений с целями "Сообщения" и "Установка приложения" или при запросе оценки показов этих наборов объявлений, мы будем выдавать сообщение об ошибке с просьбой больше не передавать этот параметр.
• При создании наборов объявлений с целями "Сообщения" и "Установка приложения" на сервере будет устанавливаться новое поле под названием targeting_as_signal. Оно может использоваться только в командах GET, чтобы рекламодатели могли проверить, не выходят ли их наборы объявлений за рамки списков детального таргетинга.

Примечание. Эти изменения в детальном таргетинге как сигнале будут применяться только к вновь созданным наборам объявлений с целями "Сообщения" и "Установка приложения".

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

• gr:post:/act_XXXX/ adsets;
• gr:get:/<adset_id>/delivery_estimate.

Упразднение вкладок на Страницах

Доступ к функциям API пользовательских вкладок на Страницах через API Graph прекращается. Мы запускаем новый интерфейс Страниц, поэтому некоторые функции API Pages со временем будут упраздняться. Функции пользовательских вкладок на Страницах перестанут работать в новом интерфейсе Страниц, поэтому мы прекращаем поддержку API для них. Мы публикуем эти обновления сейчас, чтобы у разработчиков и их клиентов было время сообщить об упразднении этих функций на Страницах и внести в них необходимые изменения. Эта функция будет полностью упразднена к 14 декабря 2022 г.

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

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

API Graph

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

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

SDK Платформы Facebook

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

• Январь 2023 г.: прекращение поддержки SDK Платформы Facebook версии 8.0 и более ранних.
• Июнь 2023 г.: прекращение поддержки SDK Платформы Facebook версии 9.0 и более ранних.
• Октябрь 2023 г.: прекращение поддержки SDK Платформы Facebook версии 11.0 и более ранних.