Архивные примечания к выпуску

На этой странице представлены примечания к выпуску устаревших версий API Display & Video 360.

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

4 декабря 2024 г.

Новые функции

Добавлена ​​поддержка значений Core и Tubi Exchange .

Увеличен максимально допустимый размер страницы для firstAndThirdPartyAudiences.list с 200 до 5000 Обновите параметр pageSize в ваших запросах к firstAndThirdPartyAudiences.list для дальнейшей оптимизации использования квоты.

v3

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    Exchange

    EXCHANGE_CORE

    EXCHANGE_TUBI

  • Для следующих методов отображения списков увеличен максимальный размер страницы:

    Метод Новый максимальный размер страницы
    firstAndThirdPartyAudiences.list 5000

22 октября 2024 г.

Новые функции

Добавлена ​​поддержка целевого показателя производительности «стоимость за просмотр».

Добавлена ​​возможность устанавливать и получать данные о местоположении подключенных устройств.

Добавлены новые настройки безопасности бренда Adloox в разделе таргетинга сторонних верификаторов .

Добавлена ​​поддержка загрузки файлов структурированных данных v8 , которая в настоящее время находится в закрытом бета-тестировании.

v3

Устаревшие значения

Поддержка SDF v5.5 прекращена в связи с прекращением его поддержки 3 октября 2024 года .

v3

  • Следующие значения перечислений устарели:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_5_5

15 августа 2024 г.

Новые функции

Добавлена ​​поддержка типа Exchange Netflix.

v3

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    Обмен

    EXCHANGE_NETFLIX

v2

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    Обмен

    EXCHANGE_NETFLIX

15 июля 2024 г.

Новые функции

В версии 3 добавлена ​​поддержка загрузки файлов структурированных данных по позициям объявлений и группам объявлений в формате QA .

v3

  • Добавлены следующие поля:

    Ресурс Поле(а)
    IdFilter

    adGroupQaIds

    lineItemQaIds

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    Тип файла

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

17 июня 2024 г.

Новые функции

Добавлена ​​поддержка управления таргетингом по ключевым словам, назначаемым на уровне рекламодателя.

В ресурс заказа на вставку добавлено новое поле optimizationObjective . Поле optimizationObjective доступно только для клиентов, включенных в список разрешенных.

v3

v2

30 мая 2024 г.

Новые функции

Добавлена ​​поддержка файлов структурированных данных (SDF) версии 7.1.

v3

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_7_1

v2

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_7_1

23 апреля 2024 г.

Новые функции

Добавлена ​​поддержка новых типов KPI, бирж и платформ приложений.

v3

v2

28 февраля 2024 г.

Новые функции

Добавлена ​​возможность явного удаления участников из целевых аудиторий клиентов.

Добавлена ​​поддержка таргетирования на новые биржи .

v3

v2

29 января 2024 г.

Новые функции

Добавлена ​​возможность получения информации о действиях Floodlight через новую службу floodlightGroups.floodlightActivities .

Добавлено новое поле, указывающее, включает ли позиция в таргетинге YouTube & Partners рекламные места Google TV.

Добавлено новое поле для отображения времени последнего входа в систему для пользователя Display & Video 360 .

v3

v2

14 ноября 2023 г.

Новые функции

Добавлена ​​поддержка передачи согласия конечного пользователя при загрузке участников аудитории Customer Match во всех работающих версиях.

v3

v2

31 октября 2023 г.

Новые функции

Версия 3 переведена из публичного бета-тестирования в общий доступ.

В версии 3 значение перечисления AdGroupFormat было переименовано для более точного отражения соответствующего формата.

Добавлена ​​поддержка файлов структурированных данных версии 7 с добавлением значения перечисления SDF_VERSION_7 в версиях 2 и 3.

v3

  • Следующие значения перечисления были удалены:

    Перечисление Ценности)
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_7

2 октября 2023 г.

Новые функции

Выпущена версия 3 для публичного бета-тестирования, которая включает следующие изменения:

  • Возможность полного управления списками местоположений, расположенных вблизи объекта, позволяющая использовать службу advertisers.locationLists.assignedLocations для создания и удаления местоположений, назначенных ресурсам LocationList TARGETING_LOCATION_TYPE_PROXIMITY .
  • Новое логическое поле enableOptimizedTargeting , заменяющее поле targetingExpansionLevel в объекте TargetingExpansionConfig .
  • Требование о наличии поля billingConfig в ресурсе Advertiser , которое необходимо указывать при выполнении запросов advertisers.create , а также нового поля billingConfig в ресурсе Partner .
  • В версии 2 добавлены новые ресурсы AdGroup и AdGroupAd , заменяющие ресурсы YoutubeAdGroup и YoutubeAdGroupAd .

Для перехода с версии 2 на версию 3 следуйте инструкциям в нашем руководстве по миграции .

В версиях 2 и 3 добавлена ​​поддержка 3 новых значений LineItemType , одного нового значения YoutubeAndPartnersBiddingStrategyType и одного нового PartnerCostType .

v3

v2

25 августа 2023 г.

Новые функции

Добавлена ​​поддержка двух бирж и двух новых типов стратегий назначения ставок YouTube и партнеров .

Добавлено новое поле effectiveContentCategory в позиции заказа YouTube & Partners, позволяющее отображать поле YoutubeAndPartnersContentCategory используемое в позиции заказа, при рассмотрении значений, присвоенных как на уровне рекламодателя, так и на уровне позиции заказа.

v2

5 июня 2023 г.

Новые функции

В версии 1 и 2 добавлено новое значение SdfVersion для файлов структурированных данных (SDF) версии 6 .

v2

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_6

v1

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    SdfVersion

    SDF_VERSION_6

9 марта 2023 г.

Новые функции

Добавлено новое значение LineItemWarningMessage , которое будет присвоено полю warningMessages позиции заказа, если для устаревшего поля excludeFirstPartyAudience установлено значение true . Поле excludeFirstPartyAudience будет выведено из эксплуатации и установлено в false после 25 марта 2023 года .

v2

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    LineItemWarningMessage

    УСТАРЕВШЕЕ ИСКЛЮЧЕНИЕ ПЕРВОЙ ЧАСТИ

v1

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    LineItemWarningMessage

    УСТАРЕВШЕЕ ИСКЛЮЧЕНИЕ ПЕРВОЙ ЧАСТИ

8 февраля 2023 г.

Новые функции

Добавлена ​​возможность получения ресурсов YouTubeAdGroup и YouTubeAdGroupAd , а также таргетинга ресурсов YouTube Ad Group . Кроме того, добавлены новые типы таргетинга, используемые на уровне YouTube Ad Groups. Подробнее см. на нашей новой странице руководства по получению ресурсов YouTube и партнеров .

В версиях 1 и 2 добавлена ​​поддержка четырех дополнительных бирж .

v2

v1

  • Добавлены следующие значения перечисления:

    Перечисление Ценности)
    Обмен

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 декабря 2022 г.

Новые функции

Версия 2 переведена из публичного бета-тестирования в общий доступ.

В ресурс AssignedTargetingOption добавлено новое поле assignedTargetingOptionIdAlias , которое можно использовать вместо assignedTargetingOptionId при получении и удалении параметров таргетинга. Это поле устанавливается только для назначенных параметров таргетинга типов, назначаемых через перечисление (enum). Значение псевдонима представляет собой соответствующее значение перечисления в виде строки.

В ресурс Advertiser добавлено новое поле billingConfig .

Добавлена ​​поддержка получения позиций в платной рекламе YouTube и партнеров, идентифицируемых тремя новыми значениями LineItemType .

В версиях 1 и 2 увеличен максимальный размер страницы до 200 для многих методов list . Размер страницы по умолчанию остался без изменений.

v2

v1

Известные проблемы

В этом обновлении исправлены следующие известные проблемы в версии 2:

27 октября 2022 г.

Добавлена ​​возможность дублирования существующей позиции в родительском InsertionOrder .

Введена поддержка записи таргетинга с частичным размещением заказов на вставку для подмножества типов таргетинга путем добавления методов create и delete в службу advertisers.insertionOrders.targetingTypes.assignedTargetingOptions .

Новые функции

v2

v1

В версию 1 новые функции не добавлены.

20 сентября 2022 г.

Выпущена версия 2 для публичного бета-тестирования, которая включает следующие изменения:

  • Возможность получать информацию о позициях в рекламной кампании YouTube и партнеров, а также их настройки таргетинга, используя методы get и list в сервисах advertisers.lineItems и advertisers.lineItems.targetingTypes.assignedTargetingOptions .
  • В сервисе advertisers.lineItems появились два новых метода массового таргетинга, позволяющие редактировать и получать назначенные параметры таргетинга для нескольких позиций в рекламной выдаче одним запросом.
  • Добавлен новый метод bulkUpdate , позволяющий пользователям обновлять entityStatus нескольких позиций в одном запросе.
  • Новая логика таргетинга требует, чтобы ресурсы AssignedTargetingOption подмножества типов таргетинга назначались и извлекались с использованием значений перечисления, а не идентификаторов параметров таргетинга, получаемых с помощью службы targetingTypes.targetingOptions .

Для перехода с версии 1 на версию 2 следуйте инструкциям в нашем руководстве по миграции .

В версии 1 добавлена ​​поддержка трех новых бирж .

Новые функции

v2

Ниже приведён список изменений между версиями v1 и v2:

v1

  • В версии 1 добавлены следующие значения перечисления:

    Перечисление Ценности)
    Обмен

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 мая 2022 г.

Добавлена ​​возможность создания ресурсов InventorySource и управления ресурсами GuaranteedOrder с помощью новых методов записи в службу inventorySources и новой службы guaranteedOrders .

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

В метод advertisers.creatives.list добавлена ​​новая функция filter параметров запроса, позволяющая пользователю получать только креативы с updateTime до или после заданной временной метки.

Добавлена ​​поддержка новейшей версии SDF, v5.5 , за счет добавления значения перечисления SdfVersion .

Новые функции

31 марта 2022 г.

Добавлена ​​поддержка получения и установки параметров таргетинга по продолжительности контента , типу потока и жанру .

В объект InsertionOrder добавлено поле billableOutcome .

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

Новые функции

2 февраля 2022 г.

Добавлена ​​поддержка создания , обновления и редактирования участников определенных ресурсов Customer Match FirstAndThirdPartyAudience . На странице «Загрузка аудиторий Customer Match» в нашем новом руководстве по использованию аудиторий подробно описано, как использовать эти новые функции.

Введено новое поле reservationType в ресурсах InsertionOrder и LineItem , которое определяет, является ли ресурс гарантированным по тегу, гарантированным программным способом или не гарантированным.

Добавлена ​​возможность получать и устанавливать, будет ли позиция автоматически нацелена на новые биржи, с помощью нового поля excludeNewExchanges .

Помимо новых функций, лимиты квот по умолчанию были увеличены вдвое.

Новые функции

8 декабря 2021 г.

Добавлена ​​поддержка таргетинга по типу аудиоконтента в рамках типа таргетинга TARGETING_TYPE_AUDIO_CONTENT_TYPE .

Новые функции

8 ноября 2021 г.

Добавлена ​​полная поддержка управления пользовательскими алгоритмами назначения ставок и их скриптами. Это включает в себя:

В наше руководство по управлению позициями добавлена ​​новая страница «Внедрение пользовательского алгоритма назначения ставок» , описывающая процесс создания пользовательского алгоритма назначения ставок, загрузки скрипта и назначения этого алгоритма в качестве стратегии назначения ставок для позиции.

Добавлена ​​поддержка новейшей версии SDF, v5.4 , за счет добавления значения перечисления SdfVersion .

Новые функции

14 сентября 2021 г.

Добавлена ​​поддержка таргетинга по близости для типов таргетинга TARGETING_TYPE_BUSINESS_CHAIN ​​и TARGETING_TYPE_POI .

Добавлена ​​возможность поиска доступных параметров таргетинга TARGETING_TYPE_BUSINESS_CHAIN ​​и TARGETING_TYPE_POI с помощью targetingTypes.targetingOptions.search , поскольку их нельзя получить с помощью методов targetingTypes.targetingOptions.get или targetingTypes.targetingOptions.list .

В ресурс Custom Bidding Algorithm добавлены новые поля sharedAdvertiserIds и customBiddingAlgorithmState , а также добавлена ​​поддержка типа пользовательского алгоритма назначения ставок GOAL_BUILDER_BASED .

В перечисление Exchange добавлены два новых значения.

Новые функции

4 августа 2021 г.

Добавлена ​​поддержка целевого инвентаризации с использованием Open Measurement в рамках типа таргетинга TARGETING_TYPE_OMID .

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

Новые функции

26 мая 2021 г.

Запущен сервис advertisers.invoices , который позволяет пользователям:

  • Получить счета-фактуры, выставленные рекламодателю в течение данного месяца.
  • Найдите код валюты, используемый рекламодателем в течение данного месяца.

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

Добавлена ​​поддержка таргетинга по позиции нативного контента в рамках нового типа таргетинга TARGETING_TYPE_NATIVE_CONTENT_POSITION .

В ресурс рекламодателя добавлено новое поле prismaEnabled , позволяющее пользователям включить интеграцию с инструментом Prisma от Mediaocean.

Включена поддержка значения перечисления ENTITY_STATUS_PAUSED для поля entityStatus рекламодателя.

Новые функции

29 апреля 2021 г.

Добавлены новые поля в ресурсы «Каналы» и «Списки минус-слов» , которые возвращают количество позиций, использующих этот ресурс для таргетинга. Включены новые свойства filter для метода списка позиций , позволяющие пользователю получать только те позиции, которые используют определенные каналы или списки минус-слов в таргетинге.

Новые функции

30 марта 2021 г.

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

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

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

Внесены многочисленные изменения в сервисы advertisers.channels.sites , partners.channels.sites и advertisers.negativeKeywordLists.negativeKeywords для упрощения управления содержимым списков каналов и минус-слов. Эти изменения включают в себя:

  • Добавлена ​​возможность replace , позволяющая пользователю полностью перезаписать существующее содержимое канала или списка минус-слов.
  • Отменено требование о том, чтобы в поля createdSites или createdNegativeKeywords запросов на массовое редактирование не включались существующие элементы.
  • Увеличение максимального количества элементов, которые могут быть возвращены на одной странице в списке сайтов или списке минус-слов .

Новые функции

Амортизация

24 февраля 2021 г.

Introduced a new insertion order targeting service and additional bulk list method enabling the retrieval of targeting assigned to insertion orders. Expanded the creative resource, adding output-only creative fields for use by third-party audio creatives. Added new performance goal types for use by insertion order and campaign resources.

Новые функции

27 января 2021 г.

Enabled retrieval and management of TV insertion orders and over-the-top line items through the introduction of a new InsertionOrderType field and a new LineItemType enum value . Added support for mobile app line items through a mobileApp line item field. Expanded exchange , google audience , and SDF support through additional enum values. Introduced the capability to filter and order advertisers.list values by the last updated time .

Новые функции

4 декабря 2020 г.

Added the capability to search for Geo Region targeting options and filter multiple resource list method results by their last updated time. Introduced a new LineItemWarningMessage to inform users of when a line item is using deprecated geographic targeting.

Новые функции

5 ноября 2020 г.

Added the capability to create, assign and activate manual triggers that initiate associated line items' spending. Introduced targeting expansion options that, when set, can expand the targeting of a line item to include users similar to those in targeted audiences. Appended custom segment ID fields to DoubleVerify and Integral Ad Science objects used in third-party verification targeting .

Новые функции

12 октября 2020 г.

Introduced retrievable warning messages to the line item resource and a click-through rate (CTR) performance goal type. Added warningMessages as a filterable field when listing line items.

In addition to new features, new quota limits are now in effect and new documentation on utilizing batch requests is available.

Новые функции

28 августа 2020 г.

Added new fields to the response of the advertiser audit method and new filterable fields to various list methods.

Новые функции

4 августа 2020 г.

Launched new user management , partner , and partner targeting services . Introduced tools to help users proactively avoid reaching account entity limits . Added support for audio line items and the use of custom bidding algorithms in line items and insertion order bid strategies.

Новые функции

24 июня 2020 г.

Launched a small update adding a create method for partner and advertiser channels, new FirstAndThirdPartyAudience fields, and additional exchange enum values.

Новые функции

2 июня 2020 г.

Introduced the ability to create, patch, and populate a subset of targetable entities and added the ability to modify advertiser-level targeting for three targeting types : channel , digital content label exclusion , and sensitive category exclusion .

Новые функции

27 апреля 2020 г.

Launched a large feature set, expanding the scope of the API beyond SDF. Added core resource management that allows you to create, retrieve, update, and delete entities such as advertisers, campaigns, insertion orders, line items and creatives. New capabilities also allow the editing of targeting at the line item level.

Новые функции

The following services have been added:

Услуга Метод(ы)
рекламодатели

создавать

удалить

получать

список

пластырь

advertisers.assets

загрузить

advertisers.campaigns

создавать

удалить

получать

список

пластырь

advertisers.channels

получать

список

advertisers.creatives

создавать

удалить

получать

список

пластырь

advertisers.insertionOrders

создавать

удалить

получать

список

пластырь

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

создавать

удалить

получать

список

пластырь

advertisers.lineItems.targetingTypes.assignedTargetingOptions

создавать

удалить

получать

список

advertisers.locationLists

получать

список

advertisers.negativeKeywordLists

получать

список

combinedAudiences

получать

список

customLists

получать

список

firstAndThirdPartyAudiences

получать

список

floodlightGroups

получать

пластырь

googleAudiences

получать

список

inventorySourceGroups

получать

список

inventorySources

получать

список

partners.channels

получать

список

partners.channels

получать

список

9 марта 2020 г.

Launched Display & Video 360 API v1. This is the initial version of the API.

Известные проблемы

Никто.