Объявленные устаревания

Хронология:

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

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

• Немедленно прекратите использовать ручные триггеры для запуска и остановки показа позиций.
• Прекратите отправлять запросы к сервису advertisers.manualTriggers .
• Обновите поля flight.flightDateType и flight.triggerId для всех позиций, использующих триггеры вручную.

Хронология:

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

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

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

Хронология:

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

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

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

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

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

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

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

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

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

Обратитесь к нашему практическому руководству по фильтрации запросов LIST для получения более подробной информации об ограничениях логических операторов.

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

Первоначальная дата вступления в силу обновлена.

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

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

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

Удалите всю логику фильтров, используя эти четыре поля, до 21 июня 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 по умолчанию.

Начиная с 26 июня 2024 г. publisherReviewStatuses станет неактивным и станет пустым при получении ресурсов Creative .

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

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION :
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION :
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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

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

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

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

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

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

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

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

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 или файлов структурированных данных.

6 марта 2025 г.:

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

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

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

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

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

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

1 апреля 2025 г.:

• Запросы advertisers.lineItems.create , пытающиеся установить поле floodlightActivityConfigs объекта ConversionCountingConfig и поле customBiddingAlgorithmId объектов MaximizeSpendBidStrategy или PerformanceGoalBidStrategy , которые не используют соответствующие действия Floodlight, вернут ошибку 400 .
• Запросы advertisers.lineItems.patch , пытающиеся обновить поле floodlightActivityConfigs объекта ConversionCountingConfig , когда установлено поле customBiddingAlgorithmId объектов MaximizeSpendBidStrategy или PerformanceGoalBidStrategy , вернут ошибку 400 .
• Записи в файлах структурированных данных позиции , которые пытаются обновить столбец «Идентификаторы действий Floodlight по конверсиям», когда установлен столбец «Идентификатор алгоритма», не будут обновляться при загрузке файла.
• customBiddingAlgorithms.patch , customBiddingAlgorithms.rules.create , customBiddingAlgorithms.scripts.create запросы на ресурсы CustomBiddingAlgorithm , назначенные позиции, вернут ошибку.

Чтобы избежать перебоев в обслуживании, обновите свою интеграцию, чтобы:

• Убедитесь, что соответствующие действия Floodlight назначены позиции до или одновременно с назначением специального алгоритма назначения ставок.
• Существующие специальные алгоритмы назначения ставок отменяются для всех позиций перед попыткой их обновления.

7 апреля 2025 г. ресурсы FirstAndThirdPartyAudience больше не будут поддерживать неограниченный срок членства в аудитории. Запросы firstAndThirdPartyAudiences.create и firstAndThirdPartyAudiences.patch , устанавливающие значение поля membershipDurationDays равным 10 000, вернут ошибку 400 . Существующие аудитории со значением membershipDurationDays , равным 10 000, будут обновлены до 540, а новая продолжительность членства будет задним числом применена к существующим членствам. Срок действия всех членств старше 540 дней истечет.

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

• Убедитесь, что ваша интеграция не устанавливает значение поля membershipDurationDays новых или существующих аудиторий равным 10 000.
• Обновите членство в существующих аудиториях электронных адресов с помощью firstAndThirdPartyAudiences.editCustomerMatchMembers .
• Регулярно обновляйте членство в аудиториях электронных адресов клиентов, чтобы размер списка ваших аудиторий не уменьшался непреднамеренно.

1 мая 2025 г. записи в файлах структурированных данных по позициям , которые пытаются установить столбец «Мультипликаторы ставок», не смогут создать или обновить ресурс при загрузке файла.