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

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

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

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

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

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

v3

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

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

    EXCHANGE_NETFLIX

v2

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

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

    EXCHANGE_NETFLIX

15 июля 2024 г.

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

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

v3

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

    Ресурс Поле(а)
    ИдФильтер

    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 и партнеры в таргетинг инвентарь Google TV.

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

v3

v2

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 of Tuk Edit.
  • Увеличение максимального количества элементов, которые могут быть возвращены на одной странице сайтов списков или перечислять отрицательные ключевые слова .

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

Деформации

24 февраля 2021 г.

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

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

27 января 2021 г.

Включено извлечение и управление заказами на вставку телевидения и чрезмерные позиции линейки посредством введения нового поля InsertionOrderType и нового значения Enum LineItemType . Добавлена ​​поддержка элементов линейки мобильных приложений через поле Linepp Line mobileApp . Экскурсированные обмены , аудиторию Google и SDF поддерживают дополнительные значения перечисления. Представил возможность фильтровать и заказать advertisers.list Список значений в последнее обновленное время .

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

4 декабря 2020 г.

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

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

5 ноября 2020 г.

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

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

12 октября 2020 г.

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

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

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

28 августа 2020 г.

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

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

4 августа 2020 г.

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

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

24 июня 2020 г.

Запустило небольшое обновление, добавив метод создания для партнеров и каналов для рекламы , новые поля FirstandThirdPartyAudience и дополнительные значения Exchange Enum.

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

02 июня 2020 года

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

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

27 апреля 2020 г.

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

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

Были добавлены следующие услуги:

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

создавать

удалить

получать

список

пластырь

рекламодатели

загрузить

Рекламодатели. Кампинги

создавать

удалить

получать

список

пластырь

Рекламодатели

получать

список

Рекламодатели. КРИТИВЫ

создавать

удалить

получать

список

пластырь

Рекламодатели. ИНСЕРИЦИЯ

создавать

удалить

получать

список

пластырь

рекламодатели. LineItems

BulkeditLineItemAssignedTargetingOptions

BulkListlineItemassIngedTargetingOptions

создавать

удалить

получать

список

пластырь

Advertisers.lineitems.targetingTypes.AssignedTargetingOptions

создавать

удалить

получать

список

Рекламодатели

получать

список

Рекламодатели

получать

список

комбинированные

получать

список

Пользовательские списки

получать

список

FirstAndThirdPartyAudiences

получать

список

Группы прожектора

получать

пластырь

Googleaudiences

получать

список

InventorySourceGroups

получать

список

Инвентаризация

получать

список

Partners.Channels

получать

список

Partners.Channels

получать

список

09 марта 2020 года

Запуск Display & Video 360 API V1. Это начальная версия API.

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

Никто.