На этой странице представлены примечания к выпуску API Display & Video 360.
Последняя версия API: v3.
15 августа 2024 г.
Новые возможности
Добавлена поддержка типа Netflix Exchange
.
v3
Были добавлены следующие значения перечисления:
Перечисление Ценности) Обмен EXCHANGE_NETFLIX
v2
Были добавлены следующие значения перечисления:
Перечисление Ценности) Обмен EXCHANGE_NETFLIX
15 июля 2024 г.
Новые возможности
Добавлена поддержка загрузки файлов структурированных данных позиций и групп объявлений в формате QA в версии 3.
v3
Добавлены следующие поля:
Ресурс Поле(а) ИдФильтер Были добавлены следующие значения перечисления:
Перечисление Ценности) тип файла 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
Добавлены следующие поля:
Ресурс Поле(а) КПИ Были добавлены следующие значения перечисления:
Перечисление Ценности) Платформа приложений ПРИЛОЖЕНИЕ_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Обмен EXCHANGE_DRAX
Тип Kpi 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
v2
Были добавлены следующие значения перечисления:
Перечисление Ценности) Платформа приложений ПРИЛОЖЕНИЕ_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Обмен EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 февраля 2024 г.
Новые возможности
Добавлена возможность явным образом удалять участников из аудиторий электронных адресов.
Добавлена поддержка таргетинга на новые биржи .
v3
Добавлены следующие поля:
Ресурс Поле(а) firstAndThirdPartyAudiences.editCustomerMatchMembers Были добавлены следующие значения перечисления:
Перечисление Ценности) Обмен EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Добавлены следующие поля:
Ресурс Поле(а) 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.
Добавлено новое поле для передачи времени последнего входа в систему пользователя Display & Video 360 .
v3
Добавлены следующие методы:
Услуга Метод(ы) FloodlightGroups.floodlightActivities Добавлены следующие поля:
Ресурс Поле(а) Пользователь YoutubeAndPartnersInventorySourceConfig
v2
Добавлены следующие методы:
Услуга Метод(ы) FloodlightGroups.floodlightActivities Добавлены следующие поля:
Ресурс Поле(а) Пользователь YoutubeAndPartnersInventorySourceConfig
14 ноября 2023 г.
Новые возможности
Добавлена поддержка передачи согласия конечного пользователя при загрузке участников аудитории электронных адресов во всех действующих версиях.
v3
Добавлены следующие поля:
Ресурс Поле(а) Контактная информацияСписок список идентификаторов мобильных устройств
v2
Добавлены следующие поля:
Ресурс Поле(а) Контактная информацияСписок список идентификаторов мобильных устройств
31 октября 2023 г.
Новые возможности
Версия 3 перенесена из общедоступной бета-версии в общедоступную.
Переименовано значение перечисления AdGroupFormat
в версии 3, чтобы более точно отразить соответствующий формат.
Добавлена поддержка файлов структурированных данных v7 с добавлением значения перечисления SDF_VERSION_7
в v2 и v3.
v3
Следующие значения перечисления были удалены:
Перечисление Ценности) Формат группы объявлений AD_GROUP_FORMAT_ACTION
Были добавлены следующие значения перечисления:
Перечисление Ценности) Формат группы объявлений AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
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
Добавлены следующие методы:
Были удалены следующие методы:
Услуга Метод(ы) рекламодатели.manualTriggers активировать
создавать
деактивировать
получать
список
пластырь
рекламодатели.youtubeAdGroupAds получать
список
Advertisers.youtubeГруппы объявлений BulkListAdGroupAssignedTargetingOptions
получать
список
рекламодатель.youtubeAdGroups.targetingTypes.assignedTargetingOptions получать
список
Изменилось следующее поведение метода:
Метод Изменения) рекламодатели.locationLists.create Теперь поддерживается создание ресурсов TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.рекламодатели.locationLists.patch Теперь поддерживается обновление ресурсов TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.рекламодатели.locationLists.assignedLocations.bulkEdit Теперь поддерживается массовое редактирование ресурсов AssignedLocation
в ресурсахTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.рекламодатели.locationLists.assignedLocations.create Теперь поддерживается создание ресурсов AssignedLocation
в ресурсахLocationList
TARGETING_LOCATION_TYPE_PROXIMITY
.Добавлены следующие параметры запроса:
Метод Параметр(ы) InventorySources.get Следующие поля стали обязательными:
Ресурс Поле(а) Рекламодатель Добавлены следующие поля:
Ресурс Поле(а) Стратегия торгов Порядок вставки Партнер Конфигурация расширения таргетинга Настройки YoutubeAndPartners YoutubeAndPartnersInventorySourceConfig Следующие поля были удалены:
Ресурс Поле(а) Порядок вставки производительностьЦель
подлежащий оплатеРезультат
Конфигурация расширения таргетинга исключитьFirstPartyAudience
таргетингExpansionLevel
Настройки YoutubeAndPartners ставкиСтратегия
Настройки третьей стороныMeasurementSettings
YoutubeAndPartnersInventorySourceConfig включитьYoutubeSearch
включитьYoutubeVideos
Были добавлены следующие значения перечисления:
Перечисление Ценности) 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
ПартнерКостТип PARTNER_COST_TYPE_SCIBIDS_FEE
Состояние готовности READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Следующие значения перечисления были удалены:
Перечисление Ценности) LineItemПредупреждениеСообщение DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
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
Добавлены следующие поля:
Ресурс Поле(а) Настройки YoutubeAndPartners Следующие поля были удалены:
Ресурс Поле(а) Источник инвентаря идентификатор субсайтепропертиид
Были добавлены следующие значения перечисления:
Перечисление Ценности) Обмен 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) v6 в v1 и v2.
v2
Были добавлены следующие значения перечисления:
Перечисление Ценности) SdfVersion SDF_VERSION_6
v1
Были добавлены следующие значения перечисления:
Перечисление Ценности) SdfVersion SDF_VERSION_6
9 марта 2023 г.
Новые возможности
Добавлено новое значение LineItemWarningMessage
, которое будет присвоено полю warningMessages
позиции, если для устаревшего поля excludeFirstPartyAudience
установлено значение true
. Поле excludeFirstPartyAudience
перестанет действовать и ему будет присвоено значение false
после 25 марта 2023 г.
v2
Были добавлены следующие значения перечисления:
Перечисление Ценности) LineItemПредупреждениеСообщение DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Были добавлены следующие значения перечисления:
Перечисление Ценности) LineItemПредупреждениеСообщение DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 февраля 2023 г.
Новые возможности
Добавлена возможность получать ресурсы YouTubeAdGroup
и YouTubeAdGroupAd
, а также таргетинг ресурсов группы объявлений YouTube . Кроме того, мы добавили новые извлекаемые типы таргетинга, используемые на уровне групп объявлений YouTube. Прочтите нашу новую страницу руководства по поиску ресурсов YouTube и партнеров для получения дополнительной информации.
Добавлена поддержка четырех дополнительных обменов в версиях 1 и 2.
v2
Добавлены следующие методы:
Услуга Метод(ы) рекламодатели.youtubeAdGroupAds Advertisers.youtubeГруппы объявлений рекламодатели.youtubeAdGroups.targetingTypes.assignedTargetingOptions Добавлены следующие поля:
Услуга Метод(ы) Назначенный вариант таргетинга Настройки YoutubeAndPartners Были добавлены следующие значения перечисления:
Перечисление Ценности) Обмен EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
Тип таргетинга 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. Размер страницы по умолчанию не изменился.
v2
Добавлены следующие поля:
Ресурс Поле(а) Рекламодатель Назначенный вариант таргетинга Были добавлены следующие значения перечисления:
Перечисление Ценности) 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:
- Назначенные параметры таргетинга для типов таргетинга, которые назначены с использованием значений перечисления в версии 2, не удалось удалить или получить с помощью их
assignedTargetingOptionId
, и вместо этого ожидалось, что пользователи будут использовать значение перечисления. Благодаря этому обновлению эти назначенные параметры таргетинга можно удалить или получить с помощьюassignedTargetingOptionId
или значения перечисления, определяемого новым полемassignedTargetingOptionIdAlias
в ресурсеAssignedTargetingOption
. - В запросе
bulkUpdate
позиции неправильно использовался параметр запросаadvertisersId
, что привело к ошибке. В этом обновлении метод был исправлен, а параметр запроса был переименован сadvertisersId
наadvertiserId
.
27 октября 2022 г.
Добавлена возможность дублировать существующую позицию внутри родительского InsertionOrder
.
Введена частичная поддержка записи таргетинга порядка размещения для подмножества типов таргетинга, а также добавлены методы create
и delete
в службу advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
.
Новые возможности
v2
Добавлены следующие методы:
Услуга Метод(ы) рекламодатели.insertionOrders.targetingTypes.assignedTargetingOptions рекламодатели.lineItems
v1
В v1 не было добавлено никаких новых функций.
20 сентября 2022 г.
Выпущена версия v2 в публичной бета-версии, которая включает следующие изменения:
- Возможность получения позиций YouTube и партнеров и их настроек таргетинга с помощью методов
get
иlist
в службахadvertisers.lineItems
иadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Два новых метода массового таргетинга в сервисе
advertisers.lineItems
, которые позволяют редактировать и получать назначенный таргетинг для нескольких позиций с помощью одного запроса. - Новый метод
bulkUpdate
, который позволяет пользователям обновлятьentityStatus
нескольких позиций в одном запросе. - Новая логика таргетинга, которая требует, чтобы ресурсы
AssignedTargetingOption
подмножества типов таргетинга назначались и извлекались с использованием значений перечисления вместо идентификаторов параметров таргетинга, полученных с помощью службыtargetingTypes.targetingOptions
.
Следуйте инструкциям в нашем руководстве по миграции , чтобы перейти с версии 1 на версию 2.
Добавлена поддержка трёх новых бирж в v1.
Новые возможности
v2
Ниже приведен список изменений между v1 и v2:
В v2 были добавлены следующие методы:
Услуга Метод(ы) рекламодатели.lineItems BulkEditAssignedTargetingOptions
В версии 2 были удалены следующие методы:
Услуга Метод(ы) рекламодатели.lineItems BulkEditLineItemAssignedTargetingOptions
BulkListLineItemAssignedTargetingOptions
В версии 2 были переименованы следующие методы:
Услуга Старое имя метода Новое имя метода рекламодатели BulkEditAdvertiserAssignedTargetingOptions
BulkListAdvertiserAssignedTargetingOptions
рекламодатели.кампании BulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions рекламодатели.insertionOrders BulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions партнеры BulkEditPartnerAssignedTargetingOptions EditAssignedTargetingOptions Ресурсы
AssignedTargetingOption
следующих типов таргетинга используют перечисления для назначения таргетинга в версии 2. ПолеassignedTargetingOptionId
для ресурсовAssignedTargetingOption
этих типов таргетинга также было обновлено в версии 2 для использования строковых версий значений перечисления:Тип таргетинга Тип перечисления TARGETING_TYPE_AGE_RANGE Возрастной диапазон TARGETING_TYPE_CONTENT_INSTREAM_POSITION Контентентинстримпозицион TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION Контентаутстримпозицион TARGETING_TYPE_DEVICE_TYPE Тип устройства TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION Уровень рейтинга контента TARGETING_TYPE_ENVIRONMENT Среда TARGETING_TYPE_EXCHANGE Обмен TARGETING_TYPE_GENDER Пол TARGETING_TYPE_HOUSEHOLD_INCOME ДомохозяйствоДоход TARGETING_TYPE_NATIVE_CONTENT_POSITION НативКонтентПозиция TARGETING_TYPE_OMID Омид TARGETING_TYPE_PARENTAL_STATUS Родительский статус TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION ЧувствительнаяКатегория TARGETING_TYPE_VIDEO_PLAYER_SIZE Размер видеоплеера TARGETING_TYPE_VIEWABILITY Видимость В версии 2 были добавлены следующие поля:
В версии 2 были удалены следующие поля:
Следующие поля стали обязательными в версии 2:
В версии 2 были добавлены следующие значения перечисления:
Перечисление Ценности) Возрастной диапазон 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
Уровень рейтинга контента 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
Тип бронирования RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
ЧувствительнаяКатегория SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Следующие значения перечисления были удалены в версии 2:
Перечисление Ценности) LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemПредупреждениеСообщение 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
Следующие значения перечисления были добавлены в v1:
Перечисление Ценности) Обмен EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 мая 2022 г.
Добавлена возможность создавать ресурсы InventorySource
и управлять ресурсами GuaranteedOrder
с помощью новых методов записи службы inventorySources
и новой службы guaranteedOrders
.
В ресурсе CustomBiddingAlgorithm
появилось поле modelReadiness
. В этом поле указывается готовность модели алгоритма для каждого рекламодателя, который может к ней получить доступ.
Включена новая функциональность параметра запроса filter
для метода advertisers.creatives.list
, который позволяет пользователю получать только объявления с updateTime
до или после заданной временной метки.
Добавлена поддержка новейшей версии SDF, v5.5 , посредством добавления значения перечисления SdfVersion
.
Новые возможности
Добавлены следующие методы:
Услуга Метод(ы) гарантированныеЗаказы инвентаризацияИсточники Добавлены следующие поля:
Ресурс Поле(а) Алгоритм пользовательского назначения ставок Источник инвентаря Были добавлены следующие значения перечисления:
Перечисление Ценности) SdfVersion Следующие методы списка теперь можно фильтровать по следующим свойствам:
Метод Поле(а) рекламодатели.creatives.list
31 марта 2022 г.
Добавлена поддержка получения и настройки таргетинга по продолжительности контента , типу потока и жанру .
В объект InsertionOrder
добавлено поле billableOutcome
.
В объект MaximizeSpendBidStrategy
добавлено поле raiseBidForDeals
, позволяющее пользователям указывать, будет ли стратегия назначения ставок применять минимальные цены рекламодателя для целевых сделок.
Новые возможности
Добавлены следующие поля:
Ресурс Поле(а) Назначенный вариант таргетинга Порядок вставки Стратегия MaximizeSpendBid Вариант таргетинга Были добавлены следующие значения перечисления:
Перечисление Ценности) Тип таргетинга
2 февраля 2022 г.
Добавлена поддержка создания , обновления и редактирования участников определенных ресурсов FirstAndThirdPartyAudience
. На странице «Загрузка списков электронных адресов» в нашем новом руководстве по использованию аудиторий подробно описано, как использовать эти новые функции.
В ресурсах InsertionOrder
и LineItem
появилось новое поле reservationType
, которое определяет, является ли ресурс гарантированным по тегам, гарантированным с алгоритмической продажей или негарантированным.
Добавлена возможность получать и устанавливать, будет ли позиция автоматически таргетингом на новые биржи, с помощью нового поля excludeNewExchanges
.
Помимо новых функций, лимиты квот по умолчанию увеличены вдвое.
Новые возможности
Добавлены следующие методы:
Услуга Метод(ы) FirstAndThirdPartyAudiences Добавлены следующие поля:
Ресурс Поле(а) Первая и третья сторонаАудитория Порядок вставки Линейный элемент
8 декабря 2021 г.
Добавлена поддержка таргетинга на аудиоконтент с типом таргетинга TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
Новые возможности
Добавлены следующие поля:
Ресурс Поле(а) Назначенный вариант таргетинга Вариант таргетинга Были добавлены следующие значения перечисления:
Перечисление Ценности) Тип таргетинга
8 ноября 2021 г.
Добавлена полная поддержка управления специальными алгоритмами назначения ставок и их скриптами. Это включает в себя:
- Функции для создания новых и обновления существующих
customBiddingAlgorithms
. - Возможность загружать сценарии посредством процесса получения доступного местоположения ресурса и последующей загрузки файла в это место.
- Новый сервис
customBiddingAlgorithms.scripts
для получения и созданияcustomBiddingScripts
.
В наше руководство по управлению позициями добавлена новая страница «Внедрение специальных ставок », где описывается процесс создания специального алгоритма назначения ставок, загрузки сценария и назначения специального алгоритма назначения ставок в качестве стратегии назначения ставок для позиции.
Добавлена поддержка новейшей версии SDF, v5.4 , посредством добавления значения перечисления SdfVersion
.
Новые возможности
Добавлены следующие методы:
Услуга Метод(ы) пользовательскиеалгоритмы назначения ставок customBiddingAlgorithms.scripts СМИ Были добавлены следующие значения перечисления:
Перечисление Ценности) 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
добавлено два новых значения.
Новые возможности
Добавлены следующие поля:
Ресурс Поле(а) Назначенный вариант таргетинга Алгоритм пользовательского назначения ставок Вариант таргетинга Тело запроса TargetingOptions.search Были добавлены следующие значения перечисления:
Перечисление Ценности) CustomBiddingAlgorithmType Обмен Тип таргетинга Следующие методы списка теперь можно фильтровать по следующим свойствам:
Метод Поле(а) customBiddingAlgorithms.list
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
рекламодателя.
Новые возможности
Добавлены следующие методы:
Услуга Метод(ы) рекламодатели.счета Добавлены следующие поля:
Ресурс Поле(а) Рекламодатель Назначенный вариант таргетинга Вариант таргетинга Были добавлены следующие значения перечисления:
Перечисление Ценности) AssignedTargetingOption.Recency Обмен Тип таргетинга Следующие значения перечисления теперь действительны для следующих полей:
Ресурс Поле Ценности) Рекламодатель статус сущности ENTITY_STATUS_PAUSED
29 апреля 2021 г.
В ресурсы «Канал» и «Список минус-слов» добавлены новые поля, которые возвращают количество позиций, использующих ресурс для таргетинга. Включены новые свойства filter
для метода списка позиций , которые позволяют пользователю получать только те позиции, которые используют определенные каналы или списки минус-слов в своем таргетинге.
Новые возможности
Добавлены следующие поля:
Ресурс Поле(а) Канал Следующие методы списка теперь можно фильтровать по следующим свойствам:
Метод Поле(а) рекламодатели.lineItems.list targetChannelId
targetNegativeKeywordListId
30 марта 2021 г.
В сервис позиций позиций добавлен новый метод , который генерирует позицию позиций с конфигурациями по умолчанию. Эти значения по умолчанию основаны на данном типе позиции , а также настройках и назначенном таргетинге родительского заказа на размещение.
Включено получение данных о таргетинге кампании с помощью новой службы таргетинга кампании и дополнительного метода массового списка .
Расширенный таргетинг приложений , позволяющий ориентировать приложения на большее количество платформ .
Внесены многочисленные изменения в сервисы advertisers.channels.sites
, partners.channels.sites
и advertisers.negativeKeywordLists.negativeKeywords
, чтобы упростить управление содержимым каналов и списков минус-слов. Эти изменения включают в себя:
- Добавление методов
replace
, которые позволяют пользователю полностью перезаписать существующее содержимое канала или списка минус-слов. - Удаление требования о том, что существующие элементы не должны быть включены в поля
createdSites
илиcreatedNegativeKeywords
запросов на массовое редактирование. - Увеличение максимального количества элементов, которые могут быть возвращены на одной странице списка сайтов или списка ответа по минус-словам .
Новые возможности
Добавлены следующие методы:
Были добавлены следующие поля:
Ресурс Поле (ы) UssedTargetingOption.appassignedTargetingOptionDetails Максимальный размер страницы был увеличен для следующих методов списка:
Метод Старый максимальный размер страницы Новый максимальный размер страницы рекламодатели. channels.sites.list 100 10000 рекламодатели 100 1000 partners.channels.sites.list 100 10000
Деформации
Следующие значения enum больше не могут быть назначены новым или существующим ресурсам:
Перевозить Ценности) PartnerRevenueModelmarkUptype Partner_revenue_model_markup_type_media_cost_markup
24 февраля 2021 г.
Представил новый сервис таргетирования заказа на вставку и дополнительные методы объема списка , позволяющий поиск таргетинга, назначенного для заказов внедрения. Расширил творческий ресурс, добавив творческие поля только для вывода для использования сторонними аудио-креативщиками. Добавлены новые типы целей производительности для использования по заказу вставки и ресурсам кампании .
Новые возможности
Были добавлены следующие методы:
Услуга Метод (S) Рекламодатели. ИНСЕРИЦИЯ Advertisers.insertionorders.TargetingTypes.AssignedTargetingOptions Были добавлены следующие поля:
Ресурс Поле (ы) Креатив Были добавлены следующие значения enum:
Перевозить Ценности) ContentInStreamposition PerformanceGoaltype Performance_goal_type_audio_completion_rate
Performance_goal_type_click_cvr
Performance_goal_type_impression_cvr
27 января 2021 г.
Включено извлечение и управление заказами на вставку телевидения и чрезмерные позиции линейки посредством введения нового поля InsertionOrderType и нового значения Enum LineItemType . Добавлена поддержка элементов линейки мобильных приложений через поле Linepp Line mobileApp
. Экскурсированные обмены , аудиторию Google и SDF поддерживают дополнительные значения перечисления. Представил возможность фильтровать и заказать advertisers.list
Список значений в последнее обновленное время .
Новые возможности
Были добавлены следующие поля:
Ресурс Поле (ы) Вставка LineItem Были добавлены следующие значения enum:
Перевозить Ценности) Обмен GOOGLEAUDIENCETYPE LineItemtype Sdfversion Следующие методы списка теперь могут быть заказаны и отфильтрованы следующими полями:
Метод Поле (ы) рекламодатели
4 декабря 2020 г.
Добавлена возможность искать параметры таргетирования GEO и отфильтровать результаты метода нескольких ресурсов по последнему обновленному времени. Представил новый LineItemWarningMessage, чтобы информировать пользователей о том, когда элемент строки использует устаревшее географическое таргетинг.
Новые возможности
Были добавлены следующие методы:
Услуга Метод (S) TargetingTypes.TargetingOptions Были добавлены следующие значения enum:
Перевозить Ценности) Обмен LineItemWarningMessage Следующие методы списка теперь могут быть заказаны и отфильтрованы следующими полями:
Метод Поле (ы) рекламодатели. Campaigns.list рекламодатели.insertionorders.list Рекламодатели. LineItems.List
5 ноября 2020 г.
Добавлена возможность создавать, назначать и активировать ручные триггеры , которые инициируют расходы ассоциированных линий. Внедренные параметры расширения таргетирования , которые при установке могут расширить целевое таргетинг позиции, чтобы включить пользователей, аналогичные тем, которые в целевой аудитории. Прилагаемые пользовательские поля идентификатора сегмента для DownVerify и интегральных объектов науки об AD, используемых в третьей стороне проверки проверки .
Новые возможности
Были добавлены следующие услуги:
Услуга Метод (S) Рекламодатели. ManualTriggers Были добавлены следующие поля:
Ресурс Поле (ы) Usdesdatargetingoption.doubleverify UssedTargetingOption.integraladScience LineItem LineItemFlight Были добавлены следующие значения enum:
Перевозить Ценности) LineItemFlightDateType Следующие методы списка теперь отфильтруются по следующим полям:
Метод Поле (ы) Рекламодатели. LineItems.List
12 октября 2020 г.
Введены поисковые предупреждающие сообщения для ресурса Line Line и тип производительности. Добавлено warningMessages
в качестве отфильтрованного поля при перечислении строк.
В дополнение к новым функциям в настоящее время действуют новые ограничения квот , и доступна новая документация по использованию пакетных запросов .
Новые возможности
Были добавлены следующие поля:
Ресурс Поле (ы) LineItem Были добавлены следующие значения enum:
Перевозить Ценности) PerformanceGoaltype Следующие методы списка теперь отфильтруются по следующим полям:
Метод Поле (ы) Рекламодатели. LineItems.List
28 августа 2020 г.
Добавлены новые поля для ответа метода аудита рекламодателя и новых фильтруемых полей в различные методы списка.
Новые возможности
Были добавлены следующие поля:
Ресурс Поле (ы) Рекламодатели. Аудж отвечает орган Следующие методы списка теперь отфильтруются по следующим полям:
Метод Поле (ы) Рекламодатели. Список рекламодатели. Campaigns.list рекламодатели.insertionorders.list Рекламодатели. LineItems.List targetingtypes.targetingoptions.list
4 августа 2020 г.
Запустили новые услуги по управлению пользователями , партнером и партнером. Внедренные инструменты, помогающие пользователям активно избегать достижения лимитов объектов учетной записи . Добавлена поддержка элементов аудио -линии и использования пользовательских алгоритмов торгов в статьях в строке и стратегии заявки на заказ .
Новые возможности
Были добавлены следующие услуги:
Услуга Метод (S) CustombiddingAlgorithms партнеры partners.targetingtypes.assignedTargetingOptions пользователи Были добавлены следующие методы:
Услуга Метод (S) рекламодатели Были добавлены следующие поля:
Ресурс Поле (ы) MaximizespendStrategy PerformanceGoalbidStrategy Были добавлены следующие значения enum:
Перечислять Ценности) Biddingstrategyperformancegoaltype LineItemtype Следующие методы списка теперь могут быть заказаны и отфильтрованы следующими полями:
Метод Поле (ы) Рекламодатели. LineItems.List Следующие прицелы были добавлены для использования для следующих служб:
Объем Услуги) https://www.googleapis.com/auth/display-vide-user-management
24 июня 2020 г.
Запустило небольшое обновление, добавив метод создания для партнеров и каналов для рекламы , новые поля FirstandThirdPartyAudience и дополнительные значения Exchange Enum.
Новые возможности
Были добавлены следующие услуги:
Услуга Метод (S) Рекламодатели Partners.Channels Были добавлены следующие поля:
Ресурс Поле (ы) FirstAndThirdPartyAudience Были добавлены следующие значения enum:
Перевозить Ценности) Обмен Следующие методы списка теперь отфильтруются по следующим полям:
Метод Поле (ы) рекламодатели. Creatives.List
02 июня 2020 г.
Представил возможность создавать, исправлять и заполнить подмножество целевых объектов и добавить возможность изменения таргетинга на уровне рекламодателя для трех типов таргетинга : канал , исключение цифрового контента и исключение конфиденциальности категории .
Новые возможности
Были добавлены следующие услуги:
Услуга Метод (S) Рекламодатели.channels.sites Рекламодатели рекламодатели Рекламоры InventorySourceGroups.AssignedInventorySources partners.channels.sites Были добавлены следующие методы:
Услуга Метод (S) рекламодатели Рекламодатели Рекламодатели Рекламодатели InventorySourceGroups Partners.Channels Были добавлены следующие поля:
Ресурс Поле (ы) рекламодатель творческий INSERTIONORD.INSERTIONORDBUDGETSEGEGME
27 апреля 2020 г.
Запустил большой набор функций, расширив объем API за пределами SDF. Добавлено управление основными ресурсами, которое позволяет вам создавать, извлекать, обновлять и удалять такие объекты, как рекламодатели, кампании, заказы внедрения, элементы линейных линий и креативщики. Новые возможности также позволяют редактировать таргетинг на уровне позиции.
Новые возможности
Были добавлены следующие услуги:
09 марта 2020 г.
Запуск Display & Video 360 API V1. Это начальная версия API.
Известные проблемы
Никто.