Архивные сообщения об устаревших функциях

В этой таблице перечислены объявленные решения об устаревании функций, которые повлияли на версии API Display & Video 360 или Structured Data File, срок действия которых истекает. Указана дата вступления в силу, описание решения об устаревании с рекомендациями по дальнейшим действиям и ссылками на соответствующую документацию.

Особенность Дата вступления в силу Описание
Ограничения на количество пунктов в списке YouTube Reach в SDF 24 марта 2025 г.

С 24 марта 2025 года для создания или обновления позиций в документах, использующих структурированные файлы данных, потребуется применение более расширенных форматов рекламы. Это означает следующее:

  • В версиях SDF v6 и v7 больше не поддерживается создание новых записей в файле позиций с Subtype "Reach".
  • Новые записи в файлах позиций SDF со значением Subtype "Reach" должны использовать значение "Responsive" в столбце " TrueView Video Ad Formats ". Существующие записи со значением Subtype "Reach" не могут обновлять значение в столбце TrueView Video Ad Formats .
  • Для добавления новых записей в файлы позиций SDF со значением Subtype "Охват" необходимо заполнить столбец " TrueView Video Ad Inventory Control ".
Новая ошибка несоответствия партнера/рекламодателя sdfdownloadtasks.create 6 марта 2025 г.

С 6 марта 2025 года запросы sdfdownloadtasks.create , использующие фильтр родительской сущности для фильтрации по рекламодателям, не являющимся дочерними элементами установленного partnerId начнут возвращать ошибку 400 .

Обновите размер страницы по умолчанию для firstAndThirdPartyAudiences.list 6 марта 2025 г.

6 марта 2025 года размер страницы по умолчанию для запросов firstAndThirdPartyAudiences.list будет изменен со 100 до 5000.

To avoid an interruption of service, update your integration to set the pageSize query parameter of your firstAndThirdPartyAudiences.list requests to your preferred page size.

Оптимизированное таргетирование позиций с использованием фиксированных ставок. 6 марта 2025 г.

6 марта 2025 года:

  • Запросы на создание или обновление ресурсов LineItem с целью установки значения true для поля BiddingStrategy fixedBid и поля TargetingExpansionConfig enableOptimizedTargeting вернут ошибку 400 .
  • Записи в структурированных файлах данных по позициям , у которых значение столбца «Тип стратегии ставок» равно «Фиксированное», а значение столбца «Оптимизированное таргетирование» равно «Истина», не будут создаваться или обновляться при загрузке файла.
  • В существующих позициях, использующих фиксированную ставку, будет отключен оптимизированный таргетинг.

Во избежание перебоев в обслуживании:

  • Обновите существующие ресурсы по позициям, использующие как фиксированные ставки, так и оптимизированный таргетинг.
  • Убедитесь, что ваша интеграция не устанавливает фиксированную стратегию назначения ставок и оптимизированный таргетинг при создании или обновлении позиций ресурсов с использованием API Display & Video 360 или структурированных файлов данных.
Ограничение частоты обновления более 30 дней 28 февраля 2025 г.

28 февраля 2025 года:

  • Запросы на создание или обновление ресурсов LineItem , InsertionOrder и Campaign с использованием объекта FrequencyCap , у которого поле timeUnit установлено в значение TIME_UNIT_LIFETIME или поле timeUnit установлено в значение TIME_UNIT_MONTH , а поле timeUnitCount установлено в значение 2, вернут ошибку 400 .
  • Записи в структурированных файлах данных «Позиция заказа», «Заказ на размещение» и «Кампания» , у которых значение столбца «Период частоты» равно «Весь срок», либо значение столбца «Период частоты» равно «Месяцы», а значение столбца «Количество случаев» равно «2», не будут созданы или обновлены при загрузке файла.
  • В существующих рекламных кампаниях, заказах на размещение рекламы и отдельных позициях будет установлен период ограничения частоты показов в 30 дней или менее.

Во избежание перебоев в обслуживании:

  • Обновите существующие ресурсы кампании, заказов на размещение рекламы и позиций, для которых период ограничения частоты показов превышает 30 дней, установив его значение равным 30 дням или менее.
  • Убедитесь, что ваша интеграция не устанавливает период ограничения частоты показов более 30 дней при создании или обновлении ресурсов кампании, заказа на размещение рекламы или позиций заказа с использованием API Display & Video 360 или структурированных файлов данных.
Отправка рейса как можно скорее. Pacing заказов на размещение рекламы. 5 ноября 2024 г.

С 5 ноября 2024 года PACING_TYPE_ASAP перестанет быть совместимым с PACING_PERIOD_FLIGHT при настройке поля « pacing заказа на вставку». pacingType для всех существующих заказов на вставку с такой конфигурацией будет обновлен до PACING_TYPE_AHEAD .

Во избежание перебоев в обслуживании обновите pacing существующих заказов на вставку, используя PACING_TYPE_ASAP и PACING_PERIOD_FLIGHT .

Оптимизированное таргетирование по отдельным позициям для подмножества стратегий назначения ставок 30 сентября 2024 г.

30 сентября 2024 года ресурсы LineItem , использующие подмножество стратегий назначения ставок, больше не будут совместимы с оптимизированным таргетингом. В связи с этим изменением ресурсы LineItem с targetingExpansion.enableOptimizedTargeting , установленным в True , и bidStrategy.maximizeSpendAutoBid.performanceGoalType , установленными в значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA , BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN или BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED , или bidStrategy.performanceGoalAutoBid.performanceGoalType , установленным в значение BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM , будут обновлены таким образом, чтобы targetingExpansion.enableOptimizedTargeting был установлен в значение False .

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

Целевая аудитория Oracle (как собственная, так и сторонняя) 30 сентября 2024 г.

30 сентября 2024 года ресурсы FirstAndThirdPartyAudience от Oracle будут прекращены. После прекращения поддержки эти аудитории будут удалены из всех существующих целевых аудиторий и объединенных аудиторий. Если позиция в базе данных ориентирована только на аудитории, поддержка которых прекращена, или негативно влияет на любые аудитории, поддержка которых прекращена, это обновление автоматически приостановит действие данной позиции.

Во избежание перебоев в обслуживании, перед датой прекращения поддержки необходимо выявить и удалить все аудитории Oracle из существующих целевых аудиторий по позициям заказа и объединенных аудиторий.

Таргетинг контента для позиций YouTube и партнеров 30 сентября 2024 г.

30 сентября 2024 года действие следующих значений для указанных типов таргетинга в рамках тарифных планов YouTube и партнеров прекратится:

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

Во избежание перебоев в предоставлении услуг, удалите этот таргетинг из всех существующих позиций в разделе «YouTube и партнеры» до даты прекращения действия услуги.

Поле publisherReviewStatuses в разделе творческих ресурсов 26 июня 2024 г.

Начиная с 26 июня 2024 года, поле publisherReviewStatuses будет упразднено и станет пустым при получении данных Creative ресурсах.

Покупка, ориентированная на результат 1 августа 2023 г.

С 1 августа 2023 года заказы на размещение рекламы, использующие систему оплаты на основе результатов, определяемую значением поля billableOutcome , равным BILLABLE_OUTCOME_PAY_PER_CLICK или BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION , и их дочерние позиции будут архивированы.

Это изменение затронет следующие запросы:

  • Попытка использовать advertisers.insertionOrders.create для создания заказа на вставку с использованием покупки на основе результатов приведет к ошибке 400
  • Попытка использовать advertisers.lineItems.create , advertisers.lineItems.duplicate или advertisers.lineItems.generateDefault для создания позиции в заказе на добавление с использованием покупки на основе результатов приведет к ошибке 400
  • Поскольку архивированные ресурсы по умолчанию не включаются в запросы LIST , затронутые ресурсы больше не будут возвращаться методами advertisers.insertionOrders.list и advertisers.lineItems.list по умолчанию.
Возможность фильтровать запросы advertisers.lineItems.list по четырем дополнительным полям. 21 июня 2023 г.

С 21 июня 2023 года advertisers.lineItems.list больше не будет поддерживать фильтрацию по следующим полям:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Чтобы избежать перебоев в обслуживании, удалите всю логику фильтрации, использующую эти четыре поля, до 21 июня 2023 года.

Возможность фильтровать или упорядочивать запросы списка по полям budget.budget_segments. date_range.end_date и flight.dateRange.endDate

Дата вступления в силу обновлена.

21 июня 2023 г.

С 21 июня 2023 года budget.budget_segments. date_range.end_date и flight.dateRange.endDate больше не будут приниматься в качестве полей в параметрах запроса filter и orderBy объектов advertisers.insertionOrders.list и advertisers.lineItems.list соответственно. После этой даты запросы, использующие эти поля в параметрах запроса filter и orderBy будут возвращать ошибку.

Во избежание перебоев в обслуживании удалите всю логику фильтрации и упорядочивания, использующую эти два поля, до 21 июня 2023 года.

Использование оператора OR между ограничениями различных полей в фильтрах LIST

21 июня 2023 г.

С 21 июня 2023 года в параметрах filter запросов LIST больше не будет возможности использовать логические операторы OR между ограничениями разных полей.

Например, ресурсы, идентифицированные с помощью строки фильтра lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" , должны быть получены с помощью двух запросов LIST со следующими строками фильтра:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Reference our how-to guide on filtering LIST requests for more details on the restrictions of logical operators.

Перед 21 июня 2023 года проверьте параметры filter всех существующих вызовов LIST и убедитесь, что в них правильно используется логический оператор OR, чтобы избежать перебоев в обслуживании.

Существующие ограничения квот API 30 мая 2023 г.

30 мая 2023 года существующие ограничения на использование будут заменены гибридной квотной структурой, которая предусматривает следующее:

  1. Устраняет квоту на количество запросов в день по каждому проекту.
  2. Вводит квоту на количество запросов в минуту на одного рекламодателя на один проект для соответствующих методов.

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

Типы аудитории на основе активности и частоты показов FirstAndThirdPartyAudience 20 мая 2023 г.

Хронология:

  • 20 мая 2023 г.: Вы больше не сможете назначать ресурсы FirstAndThirdPartyAudience с AudienceType ACTIVITY_BASED или FREQUENCY_CAP для таргетинга по позициям или заказам на добавление. Запросы, назначающие эти аудитории для таргетинга по позициям, будут возвращать ошибку. Это касается запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если создаваемая позиция будет включать устаревшие аудитории в свой таргетинг.
  • 8 июня 2023 г.: Затронутые аудитории будут удалены из всех целевых групп по позициям и заказам на размещение рекламы, а также из всех объединенных аудиторий. Если по позициям не удается показывать рекламу после удаления этих аудиторий, их показ будет приостановлен. С этой даты эти аудитории также больше не будут доступны для получения с помощью сервиса firstAndThirdPartyAudiences .

Рекомендуемые задачи:

  • Мы рекомендуем вам немедленно прекратить использование затронутых аудиторий при внесении будущих изменений в таргетинг по отдельным позициям.
  • Удалите все затронутые аудитории из существующих настроек таргетинга по позициям и заказам на размещение рекламы. Подробнее об обновлении настроек таргетинга аудитории читайте в нашем руководстве по целевым аудиториям .
Установленные приложения и новые мобильные устройства. Типы GoogleAudience 20 мая 2023 г.

Хронология:

  • 20 мая 2023 г.: Вы больше не сможете назначать ресурсы GoogleAudience с типом GoogleAudienceType GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS или GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES для таргетинга аудитории по позициям или заказам на добавление. Запросы на назначение этих аудиторий для таргетинга аудитории по позициям будут возвращать ошибку. Это касается запросов advertisers.lineItems.duplicate и advertisers.lineItems.generateDefault , если создаваемая позиция включает устаревшие аудитории в свой таргетинг.
  • 8 июня 2023 г.: Затронутые аудитории будут удалены из всех целевых групп по позициям и заказам на размещение рекламы, а также из всех объединенных аудиторий. Если по позициям не удается показывать рекламу после удаления этих аудиторий, их показ будет приостановлен. С этой даты эти аудитории также больше не будут доступны для получения через сервис googleAudiences .

Рекомендуемые задачи:

  • Мы рекомендуем вам немедленно прекратить использование затронутых аудиторий при внесении будущих изменений в таргетинг по отдельным позициям.
  • Удалите все затронутые аудитории из существующих настроек таргетинга по позициям и заказам на размещение рекламы. Подробнее об обновлении настроек таргетинга аудитории читайте в нашем руководстве по целевым аудиториям .
Ручные триггеры 17 мая 2023 г.

Хронология:

  • 17 мая 2023 г.: Показы позиций, использующих ручные триггеры, в Display & Video 360 прекратятся. Если вы активируете ручной триггер, связанный с активной позицией после этой даты, по этой позиции реклама показываться не будет.
  • 1 августа 2023 г.: сервис advertisers.manualTriggers в API DV360 версий 1 и 2, значение перечисления LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER в API DV360 версии 1 и поле LineItemFlight.triggerId в API DV360 версии 1 будут выведены из эксплуатации. После этой даты запросы к этим сервисам или полям будут возвращать ошибку.

Рекомендуемые действия:

  • Немедленно прекратите использовать ручные триггеры для запуска и остановки обработки позиций заказа.
  • Прекратите отправлять запросы к сервису advertisers.manualTriggers .
  • Обновите поля flight.flightDateType и flight.triggerId для всех позиций заказа, используя ручные триггеры.
Расширение таргетинга 25 марта 2023 г. Замена функции расширения таргетинга на оптимизированный таргетинг , внедряемая постепенно с 25 марта 2023 года по начало мая 2023 года. Соответствующие изменения в поведении API Display & Video 360 и файлов структурированных данных, а также рекомендуемые действия были объявлены в сообщении в блоге .