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

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

На главной странице примечаний к выпускам можно найти информацию обо всех выпусках рабочих версий.

4 декабря 2024 г.

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

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

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

Версия 3

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

    ПеречислениеЗначения
    Exchange

    EXCHANGE_CORE

    EXCHANGE_TUBI

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

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

22 октября 2024 г.

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

Добавлена поддержка цели по эффективности "Цена за просмотр".

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

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

Добавлена поддержка скачивания файлов структурированных данных версии 8, которая сейчас находится на этапе закрытого бета-тестирования.

Версия 3

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

Прекращена поддержка SDF версии 5.5, поскольку 3 октября 2024 г. она прекращает свое существование.

Версия 3

  • Поддержка следующих значений перечисления прекращена:

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_5_5

15 августа 2024 г.

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

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

Версия 3

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

    ПеречислениеЗначения
    Аукцион

    EXCHANGE_NETFLIX

Версия 2

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

    ПеречислениеЗначения
    Аукцион

    EXCHANGE_NETFLIX

15 июля 2024 г.

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

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

Версия 3

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

    РесурсПоля
    IdFilter

    adGroupQaIds

    lineItemQaIds

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

    ПеречислениеЗначения
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

17 июня 2024 г.

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

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

В ресурс заказа на размещение добавлено новое поле optimizationObjective. optimizationObjective доступен только клиентам из белого списка.

Версия 3

Версия 2

30 мая 2024 г.

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

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

Версия 3

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

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_7_1

Версия 2

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

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_7_1

23 апреля 2024 г.

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

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

Версия 3

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

    РесурсПоля
    KPI

    kpiAlgorithmId

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

    ПеречислениеЗначения
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Аукцион

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

Версия 2

28 февраля 2024 г.

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

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

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

Версия 3

Версия 2

29 января 2024 г.

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

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

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

Добавлено новое поле, в котором указывается время последнего входа пользователя Дисплея и Видео 360.

Версия 3

Версия 2

14 ноября 2023 г.

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

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

Версия 3

Версия 2

31 октября 2023 г.

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

Версия 3 стала общедоступной.

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

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

Версия 3

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

    ПеречислениеЗначения
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

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

    ПеречислениеЗначения
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

Версия 2

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

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_7

2 октября 2023 г.

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

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

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

Чтобы перейти с версии 2 на версию 3, следуйте инструкциям в руководстве по переносу.

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

Версия 3

Версия 2

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

    ПеречислениеЗначения
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 августа 2023 г.

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

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

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

Версия 2

5 июня 2023 г.

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

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

Версия 2

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

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_6

v1

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

    ПеречислениеЗначения
    SdfVersion

    SDF_VERSION_6

9 марта 2023 г.

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

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

Версия 2

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

    ПеречислениеЗначения
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

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

    ПеречислениеЗначения
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 февраля 2023 г.

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

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

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

Версия 2

v1

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

    ПеречислениеЗначения
    Аукцион

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 декабря 2022 г.

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

Версия 2 стала общедоступной.

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

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

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

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

Версия 2

v1

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

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

  • Назначенные параметры таргетинга, которые задаются с помощью значений перечисления в v2, нельзя было удалить или получить с помощью assignedTargetingOptionId. Вместо этого пользователям нужно было использовать значение перечисления. После этого обновления назначенные параметры таргетинга можно будет удалять или получать с помощью assignedTargetingOptionId или значения enum, определяемого новым полем assignedTargetingOptionIdAlias в ресурсе AssignedTargetingOption.
  • В запросе позиции bulkUpdate неправильно использовался параметр advertisersId, что привело к ошибке. В этом обновлении метод был исправлен, а параметр запроса переименован из advertisersId в advertiserId.

27 октября 2022 г.

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

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

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

Версия 2

v1

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

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

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

Чтобы перейти с версии 1 на версию 2, следуйте инструкциям в руководстве по переносу.

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

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

Версия 2

Ниже перечислены изменения, которые отличают версию 2 от версии 1.

v1

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

    ПеречислениеЗначения
    Аукцион

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 мая 2022 г.

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

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

Добавлена поддержка нового параметра запроса filter для метода advertisers.creatives.list, который позволяет пользователю получать только креативы с updateTime до или после определенной временной метки.

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

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

31 марта 2022 г.

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

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

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

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

2 февраля 2022 г.

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

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

Добавлена возможность получать и задавать информацию о том, настраивается ли для позиции автоматически таргетинг на новые биржи, с помощью нового поля 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 ресурса Advertiser.

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

29 апреля 2021 г.

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

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

30 марта 2021 г.

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

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

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

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

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

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

Прекращение поддержки

24 февраля 2021 г.

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

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

27 января 2021 г.

Добавлена возможность получать и изменять заказы на размещение рекламы на ТВ и позиции для инвентаря, поддерживающего технологию OTT. Для этого были введены новое поле InsertionOrderType и новое значение перечисления LineItemType. Добавлена поддержка позиций для мобильных приложений с помощью поля mobileApp. Расширенная поддержка биржи, аудитории Google и SDF за счет дополнительных значений перечисления. Добавлена возможность фильтровать и упорядочивать значения advertisers.list по времени последнего обновления.

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

4 декабря 2020 г.

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

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

5 ноября 2020 г.

Добавлена возможность создавать, назначать и активировать триггеры, настраиваемые вручную, которые инициируют расходование средств на показ рекламы в связанных позициях. Добавлены настройки расширения таргетинга, которые позволяют расширить таргетинг позиции, чтобы охватить пользователей, похожих на тех, кто входит в целевые аудитории. Поля идентификаторов особых сегментов добавлены к объектам DoubleVerify и Integral Ad Science, которые используются при таргетинге на сторонние сервисы проверки.

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

12 октября 2020 г.

В ресурс позиции добавлены извлекаемые предупреждения и тип цели по эффективности "CTR". Поле warningMessages теперь можно использовать для фильтрации при получении списка позиций.

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

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

28 августа 2020 г.

В ответ метода проверки рекламодателя добавлены новые поля, а в различные методы получения списков – новые поля, по которым можно выполнять фильтрацию.

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

4 августа 2020 г.

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

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

24 июня 2020 г.

Выпущено небольшое обновление, в котором добавлен метод создания каналов партнеров и рекламодателей, новые поля FirstAndThirdPartyAudience и дополнительные значения перечисления exchange.

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

2 июня 2020 г.

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

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

27 апреля 2020 г.

Запущен большой набор функций, расширяющий область применения API за пределы SDF. Добавлено управление основными ресурсами, которое позволяет создавать, получать, обновлять и удалять такие объекты, как рекламодатели, кампании, заказы на размещение, позиции и креативы. Новые возможности также позволяют изменять таргетинг на уровне позиции.

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

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

СервисМетод(ы)
рекламодателей

create

delete

get

list

patch

advertisers.assets

upload

advertisers.campaigns

create

delete

get

list

patch

advertisers.channels

get

list

advertisers.creatives

create

delete

get

list

patch

advertisers.insertionOrders

create

delete

get

list

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

create

delete

get

list

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

create

delete

get

list

advertisers.locationLists

get

list

advertisers.negativeKeywordLists

get

list

combinedAudiences

get

list

customLists

get

list

firstAndThirdPartyAudiences

get

list

floodlightGroups

get

patch

googleAudiences

get

list

inventorySourceGroups

get

list

inventorySources

get

list

partners.channels

get

list

partners.channels

get

list

9 марта 2020 г.

Запущена версия 1 Display & Video 360 API. Это первая версия API.

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

Нет.