REST Resource: curators.curatedPackages

Источник: CuratedPackage

Представляет собой тщательно подобранный набор товаров, созданный и управляемый куратором.

JSON-представление 
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // Union field fee can be only one of the following:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
}
Поля
name

string

Идентификатор. Уникальное имя ресурса для отобранного пакета. Формат: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Обязательный параметр. Отображаемое имя, присвоенное куратором отобранному пакету. Может использоваться для фильтрации ответа метода curatedPackages.list .

description

string

Необязательно. Описание подобранного пакета, предоставленное куратором.

createTime

string ( Timestamp format)

Только вывод. Временная метка создания отобранного пакета. Может использоваться для фильтрации ответа метода curatedPackages.list .

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

Только вывод. Временная метка последнего обновления отобранного пакета. Может использоваться для фильтрации ответа метода curatedPackages.list .

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

floorPriceCpm

object ( Money )

Необязательный параметр. Минимальная цена за тысячу показов (CPM), которую покупатель должен предложить, чтобы участвовать в аукционах за рекламные места в этом тщательно подобранном пакете. Может использоваться для фильтрации ответа метода curatedPackages.list .

state

enum ( State )

Только вывод. Состояние отобранного пакета. Может использоваться для фильтрации ответа метода curatedPackages.list .

accessSettings

object ( AccessControlSettings )

Обязательно. Настройки для управления доступом к подобранному пакету.

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

targeting

object ( PackageTargeting )

Необязательно. Критерии таргетирования для подобранного пакета.

curationFeeVisibility

enum ( CurationFeeVisibility )

Необязательно. Неизменяемо. Отображает сумму платы за пакет кураторства и плату за сегменты данных (общая плата за кураторство).

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

object ( Money )

Необязательный параметр. Комиссия CPM, взимаемая куратором с покупателей, использующих данный пакет услуг. Может использоваться для фильтрации ответа метода curatedPackages.list .

millipercentOfMediaFee

string ( int64 format)

Необязательно. Плата будет взиматься в процентах от стоимости оттиска, выраженных в миллипроцентах. Например, 1% обозначается как 1000.

Состояние

Состояние подобранного пакета.

Перечисления
STATE_UNSPECIFIED Значение по умолчанию.
ACTIVE Подборка пакетов услуг активна.
INACTIVE Подборка товаров неактивна.

AccessControlSettings

Настройки для управления доступом к тщательно отобранному пакету.

JSON-представление 
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Поля
allowlistedMediaPlanners[]

string

Обязательный параметр. Неизменяемый. Список медиапланировщиков, которым явно предоставлен доступ к подобранному пакету. Список подходящих медиапланировщиков можно найти в методе mediaPlanners.list . В данный момент в список разрешенных может быть включен только один медиапланировщик.

Формат: mediaPlanners/{mediaPlannerAccountId}

Целевое назначение пакета

Критерии таргетирования для отборочных и аукционных пакетов.

JSON-представление 
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Поля
includedDeviceTypes[]

enum ( DeviceType )

Необязательный параметр. Список типов устройств, на которые следует обратить внимание. Если поле пустое, будут выбраны все типы устройств.

includedEnvironment

enum ( Environment )

Необязательный параметр. Целевая среда. Если параметр не указан, будут выбраны все среды.

includedCreativeFormat

enum ( CreativeFormat )

Необязательный параметр. Целевой формат креатива. Если не указано, будут использоваться все типы разметки креатива.

includedAcceleratedMobilePageType

enum ( AcceleratedMobilePageType )

Необязательный параметр. Целевой тип ускоренной мобильной страницы. Если не задано, таргетинг будет осуществляться независимо от статуса AMP.

includedAuthorizedSellerStatuses[]

enum ( AuthorizedSellerStatus )

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

includedNativeInventoryTypes[]

enum ( NativeInventoryType )

Необязательно. Целевые типы товаров в инвентаре. Если поле пустое, целевые товары будут выбраны независимо от типа товара в инвентаре.

includedOpenMeasurementTypes[]

enum ( OpenMeasurementType )

Необязательный параметр. Список целевых типов открытых измерений. Если поле пустое, целевые измерения будут проводиться независимо от поддержки открытых измерений.

includedRestrictedCategories[]

enum ( RestrictedCategory )

Необязательный параметр. Список целевых категорий с ограничениями. Если поле пустое, целевые товары будут отбираться независимо от категорий с ограничениями.

includedRewardedType

enum ( RewardedType )

Необязательный параметр. Целевой тип вознаграждения. Если не задано, целевые товары будут выбраны независимо от типа вознаграждения.

videoTargeting

object ( PackageVideoTargeting )

Необязательно. Критерии таргетирования, специфичные для видео.

minimumPredictedViewabilityPercentage

string ( int64 format)

Необязательно. Целевой минимальный прогнозируемый процент видимости.

Это значение должно быть кратным 10 и находиться в диапазоне от 10 до 90 (включительно). Например, 10 — допустимое значение, а 0, 15 и 100 — нет. Значение 10 означает, что конфигурация будет подбирать только те рекламные места, для которых мы прогнозируем видимость не менее 10%.

Неуказанное значение означает, что показ рекламы будет осуществляться независимо от прогнозируемой видимости.

languageTargeting

object ( StringTargetingDimension )

Необязательный параметр. Языки для таргетирования. Если не указано, таргетирование будет осуществляться независимо от языка. Список поддерживаемых языковых кодов см. на странице https://developers.google.com/google-ads/api/data/codes-formats#languages .

includedAdSizes[]

object ( AdSize )

Необязательный параметр. Список размеров объявлений для таргетирования. Если параметр не задан, таргетирование будет осуществляться независимо от размера объявления.

В пакеты услуг, созданные специально для этих целей, поддерживаются PIXEL и INTERSTITIAL размеры рекламы.

publisherTargeting

object ( StringTargetingDimension )

Необязательно. Целевые издатели. Если не указано, рекламные места будут показываться независимо от издателя. Издатели идентифицируются по их идентификатору из файлов ads.txt / app-ads.txt. Дополнительные сведения см. на страницах https://iabtechlab.com/ads-txt/ и https://iabtechlab.com/app-ads-txt/ .

minimumPredictedClickThroughRatePercentageMillis

string ( int64 format)

Необязательно. Целевой минимальный прогнозируемый коэффициент кликабельности (CTR) в диапазоне значений [10, 10000] (0,01% - 10%). Значение 50 означает, что конфигурация будет подбирать только те рекламные места, для которых мы прогнозируем коэффициент кликабельности не менее 0,05%.

Неустановленное значение указывает на то, что рекламные объявления будут показываться независимо от прогнозируемого коэффициента кликабельности.

verticalTargeting

object ( CriteriaTargeting )

Необязательно. Вертикали, включенные или исключенные в соответствии с определением на странице https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals . Если не указано, таргетинг на рекламные места будет осуществляться независимо от вертикали.

geoTargeting

object ( CriteriaTargeting )

Необязательно. Идентификаторы географических критериев, которые следует включить или исключить, как определено в https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv . Если не указано, таргетинг на инвентарь будет производиться независимо от географического положения.

includedDataSegments[]

string

Необязательно. Активные сегменты данных, на которые будет направлена ​​атака. Если не указано, атака будет осуществляться независимо от сегментов данных. Формат: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object ( PackagePlacementTargeting )

Необязательно. Информация для таргетинга размещения, например, URL-адрес, мобильные приложения.

publisherProvidedSignalsTargeting

object ( PackagePublisherProvidedSignalsTargeting )

Необязательно. Издатель предоставляет сигналы для таргетирования. Если параметр не задан, таргетирование будет осуществляться независимо от сигналов, предоставленных издателем.

Тип устройства

Общий тип целевого устройства.

Перечисления
DEVICE_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
DEVICE_TYPE_PERSONAL_COMPUTER Предназначено для настольных или портативных компьютеров.
DEVICE_TYPE_CONNECTED_TV Целевая аудитория — устройства для просмотра телеконтента через интернет: устройства, которые транслируют телепередачи, включая смарт-телевизоры, игровые консоли и стриминговые приставки/стики.
DEVICE_TYPE_PHONE Ориентирован на высокопроизводительные мобильные устройства.
DEVICE_TYPE_TABLET Предназначено для планшетных устройств.

Среда

Целевая среда.

Перечисления
ENVIRONMENT_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
ENVIRONMENT_SITE Нацеливается на рекламные места, отображаемые на веб-сайте с поддержкой рекламы.
ENVIRONMENT_APP Нацелено на размещение товаров в мобильном приложении.

CreativeFormat

Целевой креативный формат.

Перечисления
CREATIVE_FORMAT_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
CREATIVE_FORMAT_DISPLAY Нацелен на рекламные места, предназначенные для HTML-контента.
CREATIVE_FORMAT_VIDEO Нацеливается на рекламные места, предназначенные для видеороликов.
CREATIVE_FORMAT_AUDIO Нацеливается на рекламные места, предназначенные для аудиоконтента.

AcceleratedMobilePageType

Тип реализации Accelerated Mobile Page (AMP), на который следует ориентироваться.

Перечисления
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Предназначен для размещения рекламы на стандартных веб-страницах, не использующих AMP-фреймворк.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Нацеливается на рекламные места на страницах, созданных с использованием базового HTML-фреймворка AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Нацеливается на рекламные места на страницах, использующих формат AMP Story (STAMP), оптимизированный для визуального повествования (например, полноэкранные интерактивные элементы, на которые можно нажимать).

АвторизованныйСтатусПродавца

Отражает взаимоотношения между издателем и продавцом, указанные в файле ads.txt или app-ads.txt.

Перечисления
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
AUTHORIZED_SELLER_STATUS_DIRECT Цель — определить, где продавец указан как «ПРЯМОЙ». Это означает, что издатель (владелец контента) напрямую контролирует аккаунт продавца и имеет прямой деловой договор с рекламной системой по этому аккаунту.
AUTHORIZED_SELLER_STATUS_RESELLER Цель — определить, какой рекламный инвентарь указан продавцом как «РЕСЕЛЛЕР». Это означает, что издатель уполномочил другую организацию управлять аккаунтом продавца и перепродавать его рекламное место.

NativeInventoryType

Отражает тип отображения креатива, поддерживаемый рекламным блоком, в частности, в отношении нативной рекламы.

Перечисления
NATIVE_INVENTORY_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Нацелен на рекламные места, которые принимают и отображают только нативную рекламу.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Нацеливается на рекламные места, которые принимают и отображают либо нативную рекламу, либо баннерную рекламу.

OpenMeasurementType

Тип определения открытого измерительного интерфейса (OMID), на который следует ориентироваться.

Перечисления
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
OPEN_MEASUREMENT_TYPE_OMID_V1 Предназначено для оборудования, поддерживающего определение открытого интерфейса измерений (OMID) версии 1.

Ограниченная категория

Представляет конкретные категории рекламы, таргетирование которых ограничено политикой компании.

Перечисления
RESTRICTED_CATEGORY_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
RESTRICTED_CATEGORY_ALCOHOL Нацелен на рекламные места, где издатель разрешает рекламу алкоголя.
RESTRICTED_CATEGORY_GAMBLING Нацеливается на рекламные места, где издатель разрешает размещение рекламы азартных игр.

RewardedType

Определяет критерии таргетинга в зависимости от того, предлагает ли рекламный инвентарь вознаграждение пользователю за просмотр рекламы.

Перечисления
REWARDED_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
REWARDED_TYPE_NON_REWARDED Нацеливается на рекламные места, которые НЕ предлагают пользователю явного вознаграждения за просмотр рекламы или взаимодействие с ней.
REWARDED_TYPE_REWARDED Рекламный ролик ориентирован на пользователей, которые получают вознаграждение за просмотр или взаимодействие с рекламой.

PackageVideoTargeting

Критерии таргетирования, специфичные для видео.

JSON-представление 
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Поля
includedMimeTypes[]

enum ( VideoMimeType )

Необязательно. Список целевых MIME-типов видео, использующий опубликованные IANA строки MIME-типов ( https://www.iana.org/assignments/media-types/media-types.xhtml) . Если список пуст, целевые MIME-типы будут выбраны независимо от видео.

includedMaximumAdDurationTargeting

enum ( MaximumVideoAdDuration )

Необязательный параметр. Целевая максимальная продолжительность видеорекламы. Если параметр не задан, показ рекламы будет осуществляться независимо от максимальной продолжительности видеорекламы.

includedPositionTypes[]

enum ( PositionType )

Необязательно. Типы позиций для целевой видеорекламы. Если поле пустое, таргетирование рекламного инвентаря будет осуществляться независимо от типа позиции видеорекламы.

includedContentDeliveryMethod

enum ( ContentDeliveryMethod )

Необязательный параметр. Целевой способ доставки видео. Если не задано, таргетинг на рекламные места будет осуществляться независимо от способа доставки видео.

plcmtTargeting

object ( VideoPlcmtTargeting )

Необязательный параметр. Целевые типы видеопродукции. Если параметр не задан, целевая аудитория будет выбрана независимо от типа видеопродукции.

includedPlaybackMethods[]

enum ( PlaybackMethod )

Необязательный параметр. Список целевых способов воспроизведения видео. Если поле пустое, целевые показатели будут определяться независимо от способа воспроизведения видео.

minimumPredictedCompletionRatePercentage

string ( int64 format)

Необязательно. Целевой минимальный прогнозируемый процент завершения проекта.

Это значение должно быть кратным 10 и находиться в диапазоне от 10 до 90 (включительно). Например, 10 — допустимое значение, а 0, 15 и 100 — нет. Значение 10 означает, что конфигурация будет подбирать только те рекламные места, для которых мы прогнозируем как минимум 10% вероятность завершения.

Неустановленное значение указывает на то, что целевые показатели запасов будут учитываться независимо от прогнозируемого уровня завершения заказов.

includedPlayerSizeTargeting

object ( VideoPlayerSizeTargeting )

Необязательный параметр. Целевой размер видеоплеера. Если не указано, целевые показатели будут определяться независимо от размера видеоплеера.

VideoMimeType

Типы MIME для видео, на которые следует ориентироваться.

Перечисления
VIDEO_MIME_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
VIDEO_MIME_TYPE_THREEGPP Формат контейнера 3GPP, используемый на телефонах 3G.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Контейнер MPEG-4 обычно использует кодек H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH БРОСАТЬСЯ.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (используется для платной рекламы).
VIDEO_MIME_TYPE_WEBM Контейнер WebM использует кодек VP9.

Максимальная продолжительность видеорекламы

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

Перечисления
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Применяется к видеорекламе продолжительностью до 15 секунд (0 < длительность <= 15 с).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Применяется к видеорекламе продолжительностью до 20 секунд (0 < длительность <= 20 с).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Применяется к видеорекламе продолжительностью до 30 секунд (0 < длительность <= 30 с).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Применяется к видеорекламе продолжительностью до 60 секунд (0 < длительность <= 60 с).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Применяется к видеорекламе продолжительностью до 90 секунд (0 < длительность <= 90 с).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Применяется к видеорекламе продолжительностью до 120 секунд (0 < длительность <= 120 с).

PositionType

Целевое местоположение рекламы в видеоролике.

Перечисления
POSITION_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
POSITION_TYPE_MIDROLL Рекламный ролик воспроизводится в середине видеоролика.
POSITION_TYPE_POSTROLL Рекламный ролик воспроизводится после видеоролика.
POSITION_TYPE_PREROLL Рекламный ролик воспроизводится перед видеоконтентом.

ContentDeliveryMethod

Критерии таргетирования, основанные на способе доставки видеоконтента.

Перечисления
CONTENT_DELIVERY_METHOD_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
CONTENT_DELIVERY_METHOD_STREAMING Нацеливается на видеоконтент, транслируемый в прямом эфире.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Предназначен для передачи видеоконтента, который поступает постепенно по мере необходимости воспроизведения клиентом.

VideoPlcmtTargeting

Определяет критерии таргетирования на основе типа размещения видео, часто соответствующего полю 'plcmt' в IAB OpenRTB.

JSON-представление 
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Поля
selectionType

enum ( SelectionType )

Обязательно. Тип выбора для списка видеоэлементов.

videoPlcmtTypes[]

enum ( VideoPlcmtType )

Обязательно. Список целевых типов видеопродукции. Если поле пустое, целевая продукция будет выбрана независимо от типа видеопродукции.

Тип выбора

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

Перечисления
SELECTION_TYPE_UNSPECIFIED Тип выбора не указан. Использовать не следует.
SELECTION_TYPE_INCLUDE Включены значения в измерении целевого назначения.
SELECTION_TYPE_EXCLUDE Значения в измерении целевого назначения исключаются.

VideoPlcmtType

Обозначает тип размещения видео в соответствии со стандартами OpenRTB.

Перечисления
VIDEO_PLCMT_TYPE_UNSPECIFIED Значение по умолчанию. Не следует использовать в параметрах целевого назначения.
INSTREAM Рекламные ролики перед, во время или после потокового видеоконтента, запрошенного пользователем, должны воспроизводиться в режиме «преролл», «мидролл» и «постролл». Встроенное видео должно по умолчанию иметь включенный звук при запуске проигрывателя или должно явно указывать на намерение пользователя посмотреть видеоконтент. Несмотря на наличие другого контента вокруг проигрывателя, видеоконтент должен быть в центре внимания пользователя. Он должен оставаться основным контентом на странице и единственным видеопроигрывателем, воспроизводящим звук. Если проигрыватель становится плавающим/закрепленным, последующие рекламные объявления должны точно отображать обновленный размер проигрывателя.
ACCOMPANYING_CONTENT Рекламные ролики перед началом, во время или после начала потокового видеоконтента. Видеоплеер загружается и воспроизводится до, между или после абзацев текста или графического контента и начинает воспроизведение только при попадании в область просмотра. Сопутствующий контент должен начинать воспроизведение только при попадании в область просмотра. При прокрутке страницы он может превратиться в плавающий/закрепленный плеер.
INTERSTITIAL Видеореклама, воспроизводимая без видеоконтента. Во время воспроизведения она должна быть основным элементом страницы, занимать большую часть видимой области и не должна прокручиваться за пределы поля зрения. Это может быть, например, внутриприложениевое видео или слайд-шоу.
NO_CONTENT Видеореклама, воспроизводимая без потокового видеоконтента. Это может быть размещение в слайд-шоу, нативных лентах, внутри контента или в виде фиксированных/плавающих объявлений.

Метод воспроизведения

Целевой метод воспроизведения.

Перечисления
PLAYBACK_METHOD_UNSPECIFIED Неуказанный способ воспроизведения видео. Использовать не рекомендуется.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON Воспроизведение начинается автоматически при загрузке страницы/контента.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF Воспроизведение начинается автоматически при загрузке страницы/контента, но без звука.
PLAYBACK_METHOD_CLICK_TO_PLAY Воспроизведение запускается действием пользователя (например, нажатием кнопки воспроизведения).

Целевой размер видеоплеера

Определяет размер целевого видеоплеера. Ширина и высота должны быть заданы ненулевыми значениями.

JSON-представление 
{
  "minimumWidth": string,
  "minimumHeight": string
}
Поля
minimumWidth

string ( int64 format)

Обязательно. Минимальная ширина видеоплеера в пикселях.

minimumHeight

string ( int64 format)

Обязательно. Минимальная высота видеоплеера в пикселях.

StringTargetingDimension

Универсальный таргетинг с использованием строковых значений.

JSON-представление 
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Поля
selectionType

enum ( SelectionType )

Обязательно. Как следует нацеливать действия на элементы из этого списка.

values[]

string

Обязательно. Указанные значения.

Размер рекламы

Отражает размер отдельного рекламного блока или креатива.

JSON-представление 
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Поля
width

string ( int64 format)

Ширина рекламного блока в пикселях. Это поле будет отображаться только в том случае, если тип данных — PIXEL .

height

string ( int64 format)

Высота рекламного блока в пикселях. Это поле будет отображаться только в том случае, если тип данных — PIXEL .

type

enum ( Type )

Тип размера рекламного блока.

Тип

Представляет различные типы размеров рекламных мест/креативов.

Перечисления
TYPE_UNSPECIFIED Заполнитель для неопределенного типа размера.
PIXEL Размер рекламного блока задается высотой и шириной в пикселях.
INTERSTITIAL Специальный размер для описания рекламного места в межстраничном режиме.
NATIVE Нативная (мобильная) реклама, отображаемая издателем.
FLUID Гибкий размер (адаптивный размер) может автоматически изменяться в зависимости от изменений внешней среды.

КритерииТаргетинга

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

JSON-представление 
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Поля
targetedCriteriaIds[]

string ( int64 format)

Список числовых идентификаторов, которые необходимо включить.

excludedCriteriaIds[]

string ( int64 format)

Список числовых идентификаторов, которые следует исключить.

Целевое размещение пакетов

Это параметры таргетинга, определяющие места показа рекламы, например, определенные сайты или мобильные приложения. Различные типы таргетинга по местам размещения будут объединены логическим оператором ИЛИ.

JSON-представление 
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Поля
uriTargeting

object ( StringTargetingDimension )

Необязательно. Список целевых или исключенных URL-адресов. Домены должны быть очищены от http/https (например, google.com) и могут содержать максимум 5 путей на один URL.

mobileAppTargeting

object ( StringTargetingDimension )

Необязательный параметр. Список целевых или исключенных идентификаторов мобильных приложений, принадлежащих издателям. В настоящее время поддерживаются только приложения для Android и Apple.

Идентификатор приложения Android, например, com.google.android.apps.maps, можно найти в URL-адресе Google Play Store. Идентификатор приложения iOS (число) можно найти в конце URL-адреса iTunes Store. Мобильные приложения от разработчиков либо включены, либо исключены.

includedMobileAppCategoryTargeting[]

string ( int64 format)

Необязательно. Список целевых категорий мобильных приложений.

PackagePublisherProvidedSignalsTargeting

Представляет собой таргетинг на основе сигналов, предоставляемых издателем. Различные типы сигналов, предоставляемых издателем, будут объединены логическим ИЛИ.

JSON-представление 
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Поля
audienceTargeting

object ( TaxonomyTargeting )

Необязательно. Список идентификаторов целевой или исключенной аудитории. Основано на таксономии аудиторий IAB версии 1.1 ( https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv )

contentTargeting

object ( TaxonomyTargeting )

Необязательно. Список целевых или исключенных идентификаторов контента. Основано на таксономии контента IAB версии 2.2 ( https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv )

videoAndAudioSignalsTargeting

object ( StringTargetingDimension )

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

Целевая таксономия

Определяет критерии таргетирования для обработки пространства идентификаторов таксономии аудитории и контента IAB.

JSON-представление 
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Поля
targetedTaxonomyIds[]

string

Необязательно. Список идентификаторов целевой таксономии контента.

excludedTaxonomyIds[]

string

Необязательно. Список исключенных идентификаторов таксономии контента.

CurationFeeVisibility

Отображается информация о суммарной плате за пакет кураторства и плате за сегменты данных (общая сумма платы за кураторство). Плата всегда видна создателю пакета.

Перечисления
CURATION_FEE_VISIBILITY_UNSPECIFIED Общая сумма видимых комиссионных сборов не указана.
DISCLOSED Общая сумма платы за курирование видна всем покупателям. Это значение по умолчанию, если оно не задано.
NON_DISCLOSED Общая сумма платы за курирование не видна всем покупателям.

Методы

activate

 Активирует существующий подобранный пакет.

create

 Создает новый подобранный пакет.

deactivate

 Деактивирует существующий подобранный пакет.

get

 Получает подобранный пакет по имени ресурса.

list

 Отображает список отобранных пакетов, принадлежащих указанному куратору.

patch

 Обновляет существующий подобранный пакет.