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

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

Последняя версия API: v3.

14 ноября 2023 г.

Новые возможности

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

v3

v2

31 октября 2023 г.

Новые возможности

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

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

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

v3

v2

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

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

    SDF_VERSION_7

2 октября 2023 г.

Новые возможности

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

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

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

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

v3

v2

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

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

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    ПартнерКостТип

    PARTNER_COST_TYPE_SCIBIDS_FEE

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 августа 2023 г.

Новые возможности

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

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

v2

5 июня 2023 г.

Новые возможности

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

v2

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

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

    SDF_VERSION_6

v1

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

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

    SDF_VERSION_6

9 марта 2023 г.

Новые возможности

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

v2

v1

8 февраля 2023 г.

Новые возможности

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

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

v2

v1

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

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

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 декабря 2022 г.

Новые возможности

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

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

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

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

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

v2

v1

Известные вопросы

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

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

27 октября 2022 г.

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

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

Новые возможности

v2

v1

В v1 не было добавлено никаких новых функций.

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

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

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

Добавлена ​​поддержка трёх новых бирж в v1.

Новые возможности

v2

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

v1

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

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

    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 .

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

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

Новые возможности

27 января 2021 г.

Стало возможным извлечение и управление заказами на размещение на телевидении и позициями Over-the-top благодаря введению нового поля InsertionOrderType и нового значения перечисления LineItemType . Добавлена ​​поддержка позиций для мобильных приложений через поле позиции mobileApp . Расширенная поддержка обмена , аудитории Google и SDF за счет дополнительных значений перечисления. Появилась возможность фильтровать и упорядочивать значения advertisers.list по времени последнего обновления .

Новые возможности

4 декабря 2020 г.

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

Новые возможности

November 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 .

Новые возможности

October 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.

Новые возможности

August 28, 2020

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

Новые возможности

August 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.

Новые возможности

June 24, 2020

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

Новые возможности

June 02, 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 .

Новые возможности

April 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:

Услуга Method(s)
advertisers

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

March 09, 2020

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

Known issues

Никто.