На этой странице приведены примечания к выпуску для устаревших версий Display & Video 360 API.
На главной странице примечаний к выпускам можно найти информацию обо всех выпусках рабочих версий.
4 декабря 2024 г.
Новые функции
Добавлена поддержка значений Core и Tubi Exchange.
Максимально допустимый размер страницы для firstAndThirdPartyAudiences.list увеличен с 200 до 5000. Чтобы оптимизировать использование квоты, измените параметр pageSize в запросах firstAndThirdPartyAudiences.list.
Версия 3
Добавлены следующие значения перечисления:
Перечисление Значения ExchangeEXCHANGE_COREEXCHANGE_TUBIМаксимальный размер страницы был увеличен для следующих методов:
Метод Новый максимальный размер страницы firstAndThirdPartyAudiences.list5000
22 октября 2024 г.
Новые функции
Добавлена поддержка цели по эффективности "Цена за просмотр".
Добавлена возможность задавать и получать настройки таргетинга на подключенные устройства.
В раздел Таргетинг на сторонних партнеров по проверке добавлены новые настройки безопасности бренда Adloox.
Добавлена поддержка скачивания файлов структурированных данных версии 8, которая сейчас находится на этапе закрытого бета-тестирования.
Версия 3
Добавлены следующие поля:
Объект Поля AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentДобавлены следующие значения перечисления:
Перечисление Значения DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Устаревшие значения
Прекращена поддержка SDF версии 5.5, поскольку 3 октября 2024 г. она прекращает свое существование.
Версия 3
Поддержка следующих значений перечисления прекращена:
Перечисление Значения SdfVersionSDF_VERSION_5_5
15 августа 2024 г.
Новые функции
Добавлена поддержка типа Exchange для Netflix.
Версия 3
Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_NETFLIX
Версия 2
Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_NETFLIX
15 июля 2024 г.
Новые функции
В версии 3 добавлена поддержка скачивания файлов структурированных данных для позиций и групп объявлений в формате QA.
Версия 3
Добавлены следующие поля:
Ресурс Поля IdFilter Добавлены следующие значения перечисления:
Перечисление Значения FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 июня 2024 г.
Новые функции
Добавлена поддержка управления таргетингом по ключевым словам, назначенным на уровне рекламодателя.
В ресурс заказа на размещение добавлено новое поле optimizationObjective. optimizationObjective доступен только клиентам из белого списка.
Версия 3
Добавлены следующие поля:
Ресурс Поля InsertionOrder В следующих методах теперь поддерживаются следующие типы таргетинга:
Тип таргетинга Метод(ы) TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
Версия 2
В следующих методах теперь поддерживаются следующие типы таргетинга:
Тип таргетинга Метод(ы) TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 мая 2024 г.
Новые функции
Добавлена поддержка файлов структурированных данных версии 7.1.
Версия 3
Добавлены следующие значения перечисления:
Перечисление Значения SdfVersion SDF_VERSION_7_1
Версия 2
Добавлены следующие значения перечисления:
Перечисление Значения SdfVersion SDF_VERSION_7_1
23 апреля 2024 г.
Новые функции
Добавлена поддержка новых типов KPI, бирж и платформ приложений.
Версия 3
Добавлены следующие поля:
Ресурс Поля KPI Добавлены следующие значения перечисления:
Перечисление Значения 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
Добавлены следующие значения перечисления:
Перечисление Значения AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Аукцион EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 февраля 2024 г.
Новые функции
Добавлена возможность удалять участников из аудиторий на основе списка электронных адресов.
Добавлена поддержка таргетинга на новые биржи.
Версия 3
Добавлены следующие поля:
Ресурс Поля firstAndThirdPartyAudiences.editCustomerMatchMembers Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
Версия 2
Добавлены следующие поля:
Ресурс Поля firstAndThirdPartyAudiences.editCustomerMatchMembers Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 января 2024 г.
Новые функции
Добавлена возможность получать действия Floodlight с помощью нового сервиса floodlightGroups.floodlightActivities.
Добавлено новое поле, в котором указывается, включает ли позиция для YouTube и партнерских видеоресурсов инвентарь Google TV в таргетинг.
Добавлено новое поле, в котором указывается время последнего входа пользователя Дисплея и Видео 360.
Версия 3
Добавлены следующие методы:
Сервис Метод(ы) floodlightGroups.floodlightActivities Добавлены следующие поля:
Ресурс Поля Пользователь YoutubeAndPartnersInventorySourceConfig
Версия 2
Добавлены следующие методы:
Сервис Метод(ы) floodlightGroups.floodlightActivities Добавлены следующие поля:
Ресурс Поля Пользователь YoutubeAndPartnersInventorySourceConfig
14 ноября 2023 г.
Новые функции
Добавлена поддержка передачи согласия конечного пользователя при загрузке участников аудитории на основе списков электронных адресов во всех текущих версиях.
Версия 3
Добавлены следующие поля:
Ресурс Поля ContactInfoList MobileDeviceIdList
Версия 2
Добавлены следующие поля:
Ресурс Поля ContactInfoList MobileDeviceIdList
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_PROXIMITYLocationList. - Новое логическое поле
enableOptimizedTargeting, которое заменяет полеtargetingExpansionLevelв объектеTargetingExpansionConfig. - Поле
billingConfigв ресурсеAdvertiser, которое должно быть включено при выполнении запросовadvertisers.create, и новое полеbillingConfigв ресурсеPartner. - Новые ресурсы
AdGroupиAdGroupAd, которые заменяют ресурсыYoutubeAdGroupиYoutubeAdGroupAdв версии 2.
Чтобы перейти с версии 2 на версию 3, следуйте инструкциям в руководстве по переносу.
В версиях 2 и 3 добавлена поддержка трех новых значений LineItemType, одного нового значения YoutubeAndPartnersBiddingStrategyType и одного нового значения PartnerCostType.
Версия 3
Добавлены следующие методы:
Сервис Метод(ы) advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Удалены следующие методы:
Сервис Метод(ы) advertisers.manualTriggers Активируй
create
Отмени
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Изменилось поведение следующих методов:
Метод Изменения advertisers.locationLists.create Теперь поддерживается создание ресурсов TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.patch Теперь поддерживается обновление ресурсов TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.bulkEdit Теперь поддерживается массовое редактирование ресурсов AssignedLocationв ресурсахTARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.create Теперь поддерживается создание ресурсов AssignedLocationв ресурсахTARGETING_LOCATION_TYPE_PROXIMITYLocationList.Добавлены следующие параметры запроса:
Метод Параметры inventorySources.get Обязательными стали следующие поля:
Ресурс Поля Рекламодатель Добавлены следующие поля:
Ресурс Поля BiddingStrategy InsertionOrder Партнер TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Удалены следующие поля:
Ресурс Поля InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Добавлены следующие значения перечисления:
Перечисление Значения CustomBiddingAlgorithmType RULE_BASED
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
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Удалены следующие значения перечисления:
Перечисление Значения LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
Версия 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
Добавлены следующие поля:
Ресурс Поля YoutubeAndPartnersSettings Удалены следующие поля:
Ресурс Поля InventorySource subSitePropertyId
Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
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
Добавлены следующие методы:
Сервис Метод(ы) advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Добавлены следующие поля:
Сервис Метод(ы) AssignedTargetingOption YoutubeAndPartnersSettings Добавлены следующие значения перечисления:
Перечисление Значения Аукцион EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
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
Добавлены следующие поля:
Ресурс Поля Рекламодатель AssignedTargetingOption Добавлены следующие значения перечисления:
Перечисление Значения LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Максимальный размер страницы был увеличен для следующих методов:
v1
Максимальный размер страницы был увеличен для следующих методов:
Известные проблемы
В этом обновлении устранены следующие известные проблемы версии 2:
- Назначенные параметры таргетинга, которые задаются с помощью значений перечисления в v2, нельзя было удалить или получить с помощью
assignedTargetingOptionId. Вместо этого пользователям нужно было использовать значение перечисления. После этого обновления назначенные параметры таргетинга можно будет удалять или получать с помощьюassignedTargetingOptionIdили значения enum, определяемого новым полемassignedTargetingOptionIdAliasв ресурсеAssignedTargetingOption. - В запросе позиции
bulkUpdateнеправильно использовался параметрadvertisersId, что привело к ошибке. В этом обновлении метод был исправлен, а параметр запроса переименован изadvertisersIdвadvertiserId.
27 октября 2022 г.
Добавлена возможность дублировать существующую позицию в родительском элементе InsertionOrder.
Добавлена частичная поддержка записи таргетинга в заказах на размещение для некоторых типов таргетинга. В сервис advertisers.insertionOrders.targetingTypes.assignedTargetingOptions добавлены методы create и delete.
Новые функции
Версия 2
Добавлены следующие методы:
Сервис Метод(ы) advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
В версию 1 не добавлялись новые функции.
20 сентября 2022 г.
Выпущена общедоступная бета-версия 2, в которую внесены следующие изменения:
- Возможность получать позиции для YouTube и партнерских видеоресурсов и их настройки таргетинга с помощью методов
getиlistв сервисахadvertisers.lineItemsиadvertisers.lineItems.targetingTypes.assignedTargetingOptions. - Два новых метода массового таргетинга в сервисе
advertisers.lineItems, которые позволяют изменять и получать назначенный таргетинг для нескольких позиций с помощью одного запроса. - Новый метод
bulkUpdate, который позволяет пользователям обновлятьentityStatusнескольких позиций в одном запросе. - Новая логика таргетинга, которая требует, чтобы ресурсы
AssignedTargetingOptionподмножества типов таргетинга назначались и извлекались с помощью значений перечисления, а не идентификаторов параметров таргетинга, извлекаемых с помощью сервисаtargetingTypes.targetingOptions.
Чтобы перейти с версии 1 на версию 2, следуйте инструкциям в руководстве по переносу.
Добавлена поддержка трех новых бирж в версии 1.
Новые функции
Версия 2
Ниже перечислены изменения, которые отличают версию 2 от версии 1.
В версии 2 добавлены следующие методы:
Сервис Метод(ы) advertisers.lineItems bulkEditAssignedTargetingOptions
В версии 2 удалены следующие методы:
Сервис Метод(ы) advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
В версии 2 были переименованы следующие методы:
Сервис Старое название метода Новое название метода рекламодатели bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions партнеры bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Ресурсы
AssignedTargetingOptionследующих типов таргетинга используют перечисления для назначения таргетинга в версии 2. ПолеassignedTargetingOptionIdдля ресурсовAssignedTargetingOptionэтих типов таргетинга также было обновлено в версии 2, чтобы использовать строковые версии значений перечисления:Тип таргетинга Тип перечисления TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Среда TARGETING_TYPE_EXCHANGE Аукцион TARGETING_TYPE_GENDER пол; TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Видимость В версии 2 добавлены следующие поля:
В версии 2 удалены следующие поля:
В версии 2 обязательными стали следующие поля:
В версии 2 добавлены следующие значения перечисления:
Перечисление Значения AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Аукцион EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
В версии 2 удалены следующие значения перечисления:
Перечисление Значения LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
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.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) guaranteedOrders inventorySources Добавлены следующие поля:
Ресурс Поля CustomBiddingAlgorithm InventorySource Добавлены следующие значения перечисления:
Перечисление Значения SdfVersion Теперь методы list можно фильтровать по следующим свойствам:
Метод Поля advertisers.creatives.list
31 марта 2022 г.
Добавлена поддержка получения и настройки таргетинга на продолжительность контента, тип трансляции и жанр.
В объект InsertionOrder добавлено поле billableOutcome.
В объект MaximizeSpendBidStrategy добавлено поле raiseBidForDeals, позволяющее пользователям указывать, применяются ли в стратегии назначения ставок минимальные цены рекламодателя для целевых сделок.
Новые функции
Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Добавлены следующие значения перечисления:
Перечисление Значения TargetingType
2 февраля 2022 г.
Добавлена поддержка создания, обновления и изменения участников определенных ресурсов FirstAndThirdPartyAudience для списков электронных адресов. Подробные инструкции по работе с новыми функциями вы найдете на странице Загрузка аудиторий на основе списков эл. адресов в нашем новом руководстве Использование аудиторий.
В ресурсы InsertionOrder и LineItem добавлено новое поле reservationType, которое позволяет определить, является ли ресурс гарантированным на основе тегов, гарантированным с алгоритмической продажей или негарантированным.
Добавлена возможность получать и задавать информацию о том, настраивается ли для позиции автоматически таргетинг на новые биржи, с помощью нового поля excludeNewExchanges.
Помимо новых функций, мы вдвое увеличили лимиты квот по умолчанию.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) firstAndThirdPartyAudiences Добавлены следующие поля:
Ресурс Поля FirstAndThirdPartyAudience InsertionOrder LineItem
8 декабря 2021 г.
Добавлена поддержка таргетинга по типу аудиоконтента в рамках типа таргетинга TARGETING_TYPE_AUDIO_CONTENT_TYPE.
Новые функции
Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption TargetingOption Добавлены следующие значения перечисления:
Перечисление Значения TargetingType
8 ноября 2021 г.
Добавлена полная поддержка управления алгоритмами специальных ставок и их скриптами. Примеры:
- Функции для создания новых и обновления существующих
customBiddingAlgorithms. - Возможность загружать скрипты, получая доступное местоположение ресурса и загружая файл в это местоположение.
- Новый сервис
customBiddingAlgorithms.scriptsдля получения и созданияcustomBiddingScripts.
В руководство Управление позициями добавлена новая страница Реализация специальных ставок, на которой описывается, как создать алгоритм назначения специальных ставок, загрузить скрипт и назначить алгоритм в качестве стратегии назначения ставок для позиции.
Добавлена поддержка последней версии SDF v5.4 за счет добавления значения перечисления SdfVersion.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) customBiddingAlgorithms customBiddingAlgorithms.scripts media Добавлены следующие значения перечисления:
Перечисление Значения 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 добавлены два новых значения.
Новые функции
Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Тело запроса TargetingOptions.search Добавлены следующие значения перечисления:
Перечисление Значения CustomBiddingAlgorithmType Аукцион TargetingType Теперь методы list можно фильтровать по следующим свойствам:
Метод Поля customBiddingAlgorithms.list
4 августа 2021 г.
Добавлена поддержка таргетинга на инвентарь с поддержкой Open Measurement в типе таргетинга TARGETING_TYPE_OMID.
Увеличено максимальное количество назначенных настроек таргетинга, которые могут быть возвращены на одной странице различных методов получения списка назначенных настроек таргетинга для рекламодателя, кампании, заказа на размещение и позиции с помощью параметра метода pageSize.
Новые функции
Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption TargetingOption Добавлены следующие значения перечисления:
Перечисление Значения TargetingType Максимальный размер страницы был увеличен для следующих методов:
26 мая 2021 г.
Запущен сервис advertisers.invoices, который позволяет пользователям:
- получать счета, выставленные рекламодателю в течение определенного месяца.
- посмотреть код валюты, используемый рекламодателем в течение определенного месяца.
В ресурс кампании добавлено поле campaignBudgets. Сегменты бюджета для заказов на размещение можно связать с бюджетом кампании, чтобы ограничить сумму бюджетов связанных сегментов общим бюджетом кампании.
Добавлена поддержка таргетинга на позицию нативного контента в рамках нового типа таргетинга TARGETING_TYPE_NATIVE_CONTENT_POSITION.
В ресурс рекламодателя добавлено новое поле prismaEnabled, позволяющее пользователям включить интеграцию с инструментом Prisma от Mediaocean.
Добавлена поддержка значения перечисления ENTITY_STATUS_PAUSED для поля entityStatus ресурса Advertiser.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) advertisers.invoices Добавлены следующие поля:
Ресурс Поля Рекламодатель AssignedTargetingOption TargetingOption Добавлены следующие значения перечисления:
Перечисление Значения AssignedTargetingOption.Recency Exchange TargetingType Для следующих полей теперь действительны следующие значения перечисления:
Ресурс Поле Значения Рекламодатель entityStatus ENTITY_STATUS_PAUSED
29 апреля 2021 г.
В ресурсы Channel и список минус-слов добавлены новые поля, которые возвращают количество позиций, использующих ресурс для таргетинга. В метод list для позиций добавлены новые свойства filter, которые позволяют пользователю получать только те позиции, в таргетинге которых используются определенные каналы или списки минус-слов.
Новые функции
Добавлены следующие поля:
Ресурс Поля Канал Теперь методы list можно фильтровать по следующим свойствам:
Метод Поля advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 марта 2021 г.
В сервис позиций добавлен новый метод, который создает позицию с настройками по умолчанию. Эти значения по умолчанию зависят от типа позиции, а также от настроек и таргетинга родительского заказа на размещение.
Добавлена возможность получать данные о таргетинге кампаний с помощью нового сервиса таргетинга кампаний и дополнительного метода массового получения списков.
Расширен таргетинг на приложения, чтобы можно было настраивать таргетинг на приложения на большем количестве платформ.
В сервисы advertisers.channels.sites, partners.channels.sites и advertisers.negativeKeywordLists.negativeKeywords внесены изменения, упрощающие управление контентом каналов и списков минус-слов. Основные изменения:
- Добавлены методы
replace, которые позволяют пользователю полностью перезаписать существующее содержимое канала или списка минус-слов. - Отмена требования, согласно которому в полях
createdSitesиcreatedNegativeKeywordsзапросов массового редактора не должно быть существующих элементов. - Увеличено максимальное количество элементов, которые могут быть возвращены на одной странице ответа list sites или list negative keywords.
Новые функции
Добавлены следующие методы:
Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption.AppAssignedTargetingOptionDetails Максимальный размер страницы был увеличен для следующих методов:
Метод Старый максимальный размер страницы Новый максимальный размер страницы advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Прекращение поддержки
Следующие значения перечисления больше нельзя назначать новым или существующим ресурсам:
Перечисление Значения PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 февраля 2021 г.
Добавлен новый сервис таргетинга заказов на размещение и дополнительный метод массового получения списков, позволяющий получать таргетинг, назначенный заказам на размещение. Ресурс Creative расширен за счет добавления полей креативов, доступных только для вывода, которые могут использоваться сторонними аудиокреативами. Добавлены новые типы целей по эффективности для использования с ресурсами заказов на размещение и кампаний.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Добавлены следующие поля:
Ресурс Поля Креатив Добавлены следующие значения перечисления:
Перечисление Значения ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 января 2021 г.
Добавлена возможность получать и изменять заказы на размещение рекламы на ТВ и позиции для инвентаря, поддерживающего технологию OTT. Для этого были введены новое поле InsertionOrderType и новое значение перечисления LineItemType. Добавлена поддержка позиций для мобильных приложений с помощью поля mobileApp.
Расширенная поддержка биржи, аудитории Google и SDF за счет дополнительных значений перечисления. Добавлена возможность фильтровать и упорядочивать значения advertisers.list по времени последнего обновления.
Новые функции
Добавлены следующие поля:
Ресурс Поля InsertionOrder LineItem Добавлены следующие значения перечисления:
Перечисление Значения Exchange GoogleAudienceType LineItemType SdfVersion Теперь в перечисленных ниже методах list можно сортировать и фильтровать данные по следующим полям:
Метод Поля рекламодателей
4 декабря 2020 г.
Добавлена возможность искать варианты таргетинга на географический регион и фильтровать результаты, полученные с помощью методов, которые возвращают списки ресурсов, по времени последнего обновления. Добавлено новое сообщение LineItemWarningMessage, которое информирует пользователей о том, что в позиции используется устаревший геотаргетинг.
Новые функции
Добавлены следующие методы:
Сервис Метод(ы) targetingTypes.targetingOptions Добавлены следующие значения перечисления:
Перечисление Значения Exchange LineItemWarningMessage Теперь в перечисленных ниже методах list можно сортировать и фильтровать данные по следующим полям:
Метод Поля advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 ноября 2020 г.
Добавлена возможность создавать, назначать и активировать триггеры, настраиваемые вручную, которые инициируют расходование средств на показ рекламы в связанных позициях. Добавлены настройки расширения таргетинга, которые позволяют расширить таргетинг позиции, чтобы охватить пользователей, похожих на тех, кто входит в целевые аудитории. Поля идентификаторов особых сегментов добавлены к объектам DoubleVerify и Integral Ad Science, которые используются при таргетинге на сторонние сервисы проверки.
Новые функции
Добавлены следующие сервисы:
Сервис Метод(ы) advertisers.manualTriggers Добавлены следующие поля:
Ресурс Поля AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Добавлены следующие значения перечисления:
Перечисление Значения LineItemFlightDateType Теперь в следующих методах списка можно использовать фильтры по указанным ниже полям:
Метод Поля advertisers.lineItems.list
12 октября 2020 г.
В ресурс позиции добавлены извлекаемые предупреждения и тип цели по эффективности "CTR". Поле warningMessages теперь можно использовать для фильтрации при получении списка позиций.
Помимо новых функций, теперь действуют новые квоты и доступна новая документация по использованию пакетных запросов.
Новые функции
Добавлены следующие поля:
Ресурс Поля LineItem Добавлены следующие значения перечисления:
Перечисление Значения PerformanceGoalType Теперь в следующих методах списка можно использовать фильтры по указанным ниже полям:
Метод Поля advertisers.lineItems.list
28 августа 2020 г.
В ответ метода проверки рекламодателя добавлены новые поля, а в различные методы получения списков – новые поля, по которым можно выполнять фильтрацию.
Новые функции
Добавлены следующие поля:
Ресурс Поля Тело ответа Advertisers.Audit Теперь в следующих методах списка можно использовать фильтры по указанным ниже полям:
Метод Поля advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 августа 2020 г.
Запущены новые сервисы: управление доступом, партнер и таргетинг на партнеров. Добавлены инструменты, которые помогают пользователям не достигать лимитов на количество объектов в аккаунте. Добавлена поддержка аудиопозиций и алгоритмов специальных ставок в стратегиях назначения ставок для позиций и заказов на размещение.
Новые функции
Добавлены следующие сервисы:
Сервис Метод(ы) customBiddingAlgorithms партнеры partners.targetingTypes.assignedTargetingOptions users Добавлены следующие методы:
Сервис Метод(ы) рекламодателей Добавлены следующие поля:
Ресурс Поля MaximizeSpendBidStrategy PerformanceGoalBidStrategy Добавлены следующие значения перечисления:
Перечисление Значения BiddingStrategyPerformanceGoalType LineItemType Теперь в перечисленных ниже методах list можно сортировать и фильтровать данные по следующим полям:
Метод Поля advertisers.lineItems.list Для использования со следующими сервисами были добавлены следующие области действия:
Область действия Сервисы https://www.googleapis.com/auth/display-video-user-management
24 июня 2020 г.
Выпущено небольшое обновление, в котором добавлен метод создания каналов партнеров и рекламодателей, новые поля FirstAndThirdPartyAudience и дополнительные значения перечисления exchange.
Новые функции
Добавлены следующие сервисы:
Сервис Метод(ы) advertisers.channels partners.channels Добавлены следующие поля:
Ресурс Поля FirstAndThirdPartyAudience Добавлены следующие значения перечисления:
Перечисление Значения Exchange Теперь в следующих методах списка можно использовать фильтры по указанным ниже полям:
Метод Поля advertisers.creatives.list
2 июня 2020 г.
Добавлена возможность создавать, исправлять и заполнять подмножество объектов, на которые можно настроить таргетинг, а также изменять таргетинг на уровне рекламодателя для трех типов таргетинга: канал, исключение ярлыка цифрового контента и исключение деликатной категории.
Новые функции
Добавлены следующие сервисы:
Добавлены следующие методы:
Сервис Метод(ы) рекламодателей advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Добавлены следующие поля:
Ресурс Поля рекламодатель creative insertionOrder.insertionOrderBudgetSegment
27 апреля 2020 г.
Запущен большой набор функций, расширяющий область применения API за пределы SDF. Добавлено управление основными ресурсами, которое позволяет создавать, получать, обновлять и удалять такие объекты, как рекламодатели, кампании, заказы на размещение, позиции и креативы. Новые возможности также позволяют изменять таргетинг на уровне позиции.
Новые функции
Добавлены следующие сервисы:
9 марта 2020 г.
Запущена версия 1 Display & Video 360 API. Это первая версия API.
Известные проблемы
Нет.