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

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

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

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 . После 25 марта 2023 г. поле excludeFirstPartyAudience станет неактивным и ему будет присвоено значение false .

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

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

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

4 декабря 2020 г.

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

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

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

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

создавать

удалить

получать

список

пластырь

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

загрузить

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

создавать

удалить

получать

список

пластырь

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

получать

список

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

создавать

удалить

получать

список

пластырь

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

создавать

удалить

получать

список

пластырь

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

BultkeditLineItemAssignedTargetingOptions

BulkListlineItemassIngedTargetingOptions

создавать

удалить

получать

список

пластырь

Advertisers.lineitems.targetingTypes.AssignedTargetingOptions

создавать

удалить

получать

список

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

получать

список

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

получать

список

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

получать

список

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

получать

список

FirstAndThirdPartyAudiences

получать

список

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

получать

пластырь

Googleaudiences

получать

список

InventorySourceGroups

получать

список

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

получать

список

Partners.Channels

получать

список

Partners.Channels

получать

список

09 марта 2020 г.

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

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

Никто.