REST Resource: targetingTypes.targetingOptions

Ресурс: TargetingOption

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

JSON-представление 
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "contentThemeDetails": {
    object (ContentThemeTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Поля
name

string

Только для вывода. Название ресурса для этого параметра таргетинга.
targetingOptionId

string

Только для вывода. Уникальный идентификатор этого варианта таргетинга. Кортеж {targetingType, targetingOptionId} будет уникальным.
targetingType

enum (TargetingType)

Только для вывода. Тип этого параметра таргетинга.
Подробная информация о параметрах таргетинга. В сведениях можно заполнить только одно поле, и оно должно соответствовать targeting_type. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Подробные сведения о ярлыке цифрового контента.
sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Подробные сведения о деликатных категориях.
contentThemeDetails

object (ContentThemeTargetingOptionDetails)

Сведения о теме контента.
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Сведения о категории приложения.
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Сведения о положении на экране.
contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Подробные сведения о позиции контента вне видеоконтента.
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Подробные сведения о позиции контента в видео.
videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

Сведения о размере видеопроигрывателя.
ageRangeDetails

object (AgeRangeTargetingOptionDetails)

Сведения о возрастном диапазоне.
parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

Сведения о наличии детей.
userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

Сведения о контенте с вознаграждением для пользователей.
householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Сведения о семейном доходе.
genderDetails

object (GenderTargetingOptionDetails)

Сведения о поле.
deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

Сведения о типе устройства.
browserDetails

object (BrowserTargetingOptionDetails)

Сведения о браузере.
carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

Сведения об операторе связи и интернет-провайдере.
environmentDetails

object (EnvironmentTargetingOptionDetails)

Сведения о среде.
operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

Сведения о ресурсах операционной системы.
deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Сведения о марке и модели устройства.
viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Подробные сведения о ресурсе видимости.
categoryDetails

object (CategoryTargetingOptionDetails)

Сведения о ресурсе категории.
languageDetails

object (LanguageTargetingOptionDetails)

Сведения о языковом ресурсе.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Сведения о ресурсе со статусом авторизованного продавца.
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Сведения о ресурсе географического региона.
exchangeDetails

object (ExchangeTargetingOptionDetails)

Сведения об обмене.
subExchangeDetails

object (SubExchangeTargetingOptionDetails)

Сведения о вспомогательном аукционе.
poiDetails

object (PoiTargetingOptionDetails)

Сведения о ресурсе POI.
businessChainDetails

object (BusinessChainTargetingOptionDetails)

Сведения о ресурсе сетевого бизнеса.
contentDurationDetails

object (ContentDurationTargetingOptionDetails)

Сведения о ресурсе "Длительность контента".
contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

Сведения о ресурсе типа потока контента.
nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

Сведения о позиции нативного контента.
omidDetails

object (OmidTargetingOptionDetails)

Сведения об инвентаре с поддержкой Open Measurement.
audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

Сведения о типе аудиоконтента.
contentGenreDetails

object (ContentGenreTargetingOptionDetails)

Сведения о ресурсе жанра контента.
auctionPackageDetails

object (AuctionPackageTargetingOptionDetails)

Сведения о пакете для аукционов.
Конец взаимоисключающих полей.

DigitalContentLabelTargetingOptionDetails

Представляет уровень возрастных ограничений цифрового контента, на который можно настроить таргетинг. Оно будет указано в поле digitalContentLabelDetails объекта TargetingOption, если значением поля targetingType является TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

JSON-представление 
{
  "contentRatingTier": enum (ContentRatingTier)
}
Поля
contentRatingTier

enum (ContentRatingTier)

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

SensitiveCategoryTargetingOptionDetails

Представляет деликатную категорию, на которую можно настроить таргетинг. Оно будет указано в поле sensitiveCategoryDetails объекта TargetingOption, если значением поля targetingType является TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

JSON-представление 
{
  "sensitiveCategory": enum (SensitiveCategory)
}
Поля
sensitiveCategory

enum (SensitiveCategory)

Только для вывода. Перечисление для классификатора контента деликатных категорий в Дисплее и Видео 360.

ContentThemeTargetingOptionDetails

Представляет тему контента, на которую можно настроить таргетинг. Оно будет указано в поле contentThemeDetails объекта TargetingOption, если значением поля targetingType является TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

JSON-представление 
{
  "contentTheme": enum (ContentTheme)
}
Поля
contentTheme

enum (ContentTheme)

Только для вывода. Перечисление для классификатора контента по темам контента в DV360.

AppCategoryTargetingOptionDetails

Представляет собой набор приложений, на которые можно настроить таргетинг. Коллекция позволяет настраивать таргетинг на динамические группы связанных приложений, которые поддерживаются платформой, например All Apps/Google Play/Games. Это значение будет указано в поле appCategoryDetails, если значение поля targetingType – TARGETING_TYPE_APP_CATEGORY.

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

string

Только для вывода. Название коллекции приложений.

OnScreenPositionTargetingOptionDetails

Позиция на экране, на которую можно настроить таргетинг. Подходит для медийных и видеообъявлений. Это значение будет указано в поле onScreenPositionDetails, если значение поля targetingType – TARGETING_TYPE_ON_SCREEN_POSITION.

JSON-представление 
{
  "onScreenPosition": enum (OnScreenPosition)
}
Поля
onScreenPosition

enum (OnScreenPosition)

Только для вывода. Положение на экране.

ContentOutstreamPositionTargetingOptionDetails

Представляет позицию вне видеоконтента, на которую можно настроить таргетинг и которая может использоваться для медийных и видеообъявлений. Это значение будет указано в поле contentOutstreamPositionDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

JSON-представление 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
Поля
contentOutstreamPosition

enum (ContentOutstreamPosition)

Только для вывода. Позиция контента Out-Stream.

ContentInstreamPositionTargetingOptionDetails

Представляет позицию In-Stream в контенте, на которую можно настроить таргетинг и которая может использоваться видео- и аудиообъявлениями. Это значение будет указано в поле contentInstreamPositionDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

JSON-представление 
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
Поля
contentInstreamPosition

enum (ContentInstreamPosition)

Только для вывода. Позиция контента в видео.

VideoPlayerSizeTargetingOptionDetails

Размер видеопроигрывателя, на который можно настроить таргетинг. Это значение будет указано в поле videoPlayerSizeDetails, если значение поля targetingType – TARGETING_TYPE_VIDEO_PLAYER_SIZE.

JSON-представление 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Поля
videoPlayerSize

enum (VideoPlayerSize)

Только для вывода. Размер видеопроигрывателя.

AgeRangeTargetingOptionDetails

Представляет возрастной диапазон, на который можно настроить таргетинг. Это значение будет указано в поле ageRangeDetails, если значение поля targetingType – TARGETING_TYPE_AGE_RANGE.

JSON-представление 
{
  "ageRange": enum (AgeRange)
}
Поля
ageRange

enum (AgeRange)

Только для вывода. Возрастной диапазон аудитории.

ParentalStatusTargetingOptionDetails

Представляет статус наличия детей, на который можно настроить таргетинг. Это значение будет указано в поле parentalStatusDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_PARENTAL_STATUS.

JSON-представление 
{
  "parentalStatus": enum (ParentalStatus)
}
Поля
parentalStatus

enum (ParentalStatus)

Только для вывода. Наличие детей у аудитории.

UserRewardedContentTargetingOptionDetails

Статус контента с вознаграждением, на который можно настроить таргетинг (только для видеообъявлений). Это значение будет указано в поле userRewardedContentDetails, если значение поля targetingType – TARGETING_TYPE_USER_REWARDED_CONTENT.

JSON-представление 
{
  "userRewardedContent": enum (UserRewardedContent)
}
Поля
userRewardedContent

enum (UserRewardedContent)

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

HouseholdIncomeTargetingOptionDetails

Представляет семейный доход, на который можно настроить таргетинг. Это значение будет указано в поле householdIncomeDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_HOUSEHOLD_INCOME.

JSON-представление 
{
  "householdIncome": enum (HouseholdIncome)
}
Поля
householdIncome

enum (HouseholdIncome)

Только для вывода. Семейный доход аудитории.

GenderTargetingOptionDetails

Представляет пол, на который можно настроить таргетинг. Это значение будет указано в поле genderDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_GENDER.

JSON-представление 
{
  "gender": enum (Gender)
}
Поля
gender

enum (Gender)

Только для вывода. Пол аудитории.

DeviceTypeTargetingOptionDetails

Тип устройства, на которое можно настроить таргетинг. Это значение будет указано в поле deviceTypeDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_DEVICE_TYPE.

JSON-представление 
{
  "deviceType": enum (DeviceType)
}
Поля
deviceType

enum (DeviceType)

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

BrowserTargetingOptionDetails

Браузер, на который можно настроить таргетинг. Это значение будет указано в поле browserDetails, если значение поля targetingType – TARGETING_TYPE_BROWSER.

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

string

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

CarrierAndIspTargetingOptionDetails

Представляет оператора связи или интернет-провайдера, на которого можно настроить таргетинг. Это значение будет указано в поле carrierAndIspDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_CARRIER_AND_ISP.

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

string

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

enum (CarrierAndIspType)

Только для вывода. Тип, указывающий, является ли это оператором связи или интернет-провайдером.

CarrierAndIspType

Тип CarrierAndIspTargetingOption.

Перечисления
CARRIER_AND_ISP_TYPE_UNSPECIFIED Значение по умолчанию, если тип не указан или неизвестен в этой версии.
CARRIER_AND_ISP_TYPE_ISP Указывает, что этот ресурс таргетинга относится к интернет-провайдеру.
CARRIER_AND_ISP_TYPE_CARRIER Указывает, что этот ресурс таргетинга относится к оператору мобильной связи.

EnvironmentTargetingOptionDetails

Представляет платформу, на которую можно настроить таргетинг. Это значение будет указано в поле environmentDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_ENVIRONMENT.

JSON-представление 
{
  "environment": enum (Environment)
}
Поля
environment

enum (Environment)

Только для вывода. Среда показа.

OperatingSystemTargetingOptionDetails

Представляет операционную систему, на которую можно настроить таргетинг. Это значение будет указано в поле operatingSystemDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_OPERATING_SYSTEM.

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

string

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

DeviceMakeModelTargetingOptionDetails

Представляет марку и модель устройства, на которое можно настроить таргетинг. Это значение будет указано в поле deviceMakeModelDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

ViewabilityTargetingOptionDetails

Представляет видимость, на которую можно настроить таргетинг. Это значение будет указано в поле viewabilityDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_VIEWABILITY.

JSON-представление 
{
  "viewability": enum (Viewability)
}
Поля
viewability

enum (Viewability)

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

CategoryTargetingOptionDetails

Представляет категорию, на которую можно настроить таргетинг. Это значение будет указано в поле categoryDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_CATEGORY.

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

string

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

LanguageTargetingOptionDetails

Язык, на который можно настроить таргетинг. Это значение будет указано в поле languageDetails, если значение поля targetingType – TARGETING_TYPE_LANGUAGE.

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

string

Только для вывода. Отображаемое название языка (например, "Французский").

AuthorizedSellerStatusTargetingOptionDetails

Статус авторизованного продавца, на которого можно настроить таргетинг. Это значение будет указано в поле authorizedSellerStatusDetails, если значение поля targetingType – TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

JSON-представление 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
Поля
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Только для вывода. Статус авторизованного продавца.

GeoRegionTargetingOptionDetails

Представляет географический регион, на который можно настроить таргетинг. Это значение будет указано в поле geoRegionDetails, если значение поля targetingType – TARGETING_TYPE_GEO_REGION.

JSON-представление 
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
Поля
displayName

string

Только для вывода. Отображаемое название географического региона (например, "Онтарио, Канада").
geoRegionType

enum (GeoRegionType)

Только для вывода. Тип таргетинга на географический регион.

ExchangeTargetingOptionDetails

Представляет биржу, на которую можно настроить таргетинг. Это значение будет указано в поле exchangeDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_EXCHANGE.

JSON-представление 
{
  "exchange": enum (Exchange)
}
Поля
exchange

enum (Exchange)

Только для вывода. Тип биржи.

SubExchangeTargetingOptionDetails

Представляет вспомогательную биржу, на которую можно настроить таргетинг. Это значение будет указано в поле subExchangeDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_SUB_EXCHANGE.

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

string

Только для вывода. Отображаемое название дочерней биржи.

PoiTargetingOptionDetails

Представляет объект инфраструктуры, на который можно настроить таргетинг. Это значение будет указано в поле poiDetails, если значение поля targetingType – TARGETING_TYPE_POI.

JSON-представление 
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
Поля
latitude

number

Только для вывода. Широта объекта инфраструктуры, округленная до шестого знака после запятой.
longitude

number

Только для вывода. Долгота объекта инфраструктуры, округленная до шестого знака после запятой.
displayName

string

Только для вывода. Отображаемое название объекта инфраструктуры(например, "Таймс-сквер", "Спейс-Нидл"), за которым следует его полный адрес, если он доступен.

BusinessChainTargetingOptionDetails

Представляет сетевой бизнес, на который можно настроить таргетинг в определенном регионе. Это значение будет указано в поле businessChainDetails, если значение поля targetingType – TARGETING_TYPE_BUSINESS_CHAIN.

JSON-представление 
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
Поля
businessChain

string

Только для вывода. Отображаемое название сети, например "KFC", "Chase Bank".
geoRegion

string

Только для вывода. Отображаемое название географического региона, например "Онтарио, Канада".
geoRegionType

enum (GeoRegionType)

Только для вывода. Тип географического региона.

ContentDurationTargetingOptionDetails

Представляет продолжительность контента, на который можно настроить таргетинг. Это значение будет указано в поле contentDurationDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_DURATION.

JSON-представление 
{
  "contentDuration": enum (ContentDuration)
}
Поля
contentDuration

enum (ContentDuration)

Только для вывода. Продолжительность контента.

ContentStreamTypeTargetingOptionDetails

Отражает тип потока контента, на который можно настроить таргетинг. Это значение будет указано в поле contentStreamTypeDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_STREAM_TYPE.

JSON-представление 
{
  "contentStreamType": enum (ContentStreamType)
}
Поля
contentStreamType

enum (ContentStreamType)

Только для вывода. Тип потока контента.

NativeContentPositionTargetingOptionDetails

Представляет позицию нативного контента, на которую можно настроить таргетинг. Это значение будет указано в поле nativeContentPositionDetails, если значение поля targetingType – TARGETING_TYPE_NATIVE_CONTENT_POSITION.

JSON-представление 
{
  "contentPosition": enum (NativeContentPosition)
}
Поля
contentPosition

enum (NativeContentPosition)

Только для вывода. Позиция контента.

OmidTargetingOptionDetails

Представляет тип инвентаря с поддержкой Open Measurement, на который можно настроить таргетинг. Это значение будет указано в поле omidDetails, если значение поля targetingType – TARGETING_TYPE_OMID.

JSON-представление 
{
  "omid": enum (Omid)
}
Поля
omid

enum (Omid)

Только для вывода. Тип инвентаря, для которого включена поддержка Open Measurement.

AudioContentTypeTargetingOptionDetails

Отражает тип аудиоконтента, на который можно настроить таргетинг. Это значение будет указано в поле audioContentTypeDetails, если значение поля targetingType – TARGETING_TYPE_AUDIO_CONTENT_TYPE.

JSON-представление 
{
  "audioContentType": enum (AudioContentType)
}
Поля
audioContentType

enum (AudioContentType)

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

ContentGenreTargetingOptionDetails

Представляет жанр контента, на который можно настроить таргетинг. Это значение будет указано в поле contentGenreDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_GENRE.

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

string

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

AuctionPackageTargetingOptionDetails

Представляет пакет для аукционов, на который можно настроить таргетинг. Это значение будет указано в поле auctionPackageDetails объекта TargetingOption, если для поля targetingType задано значение TARGETING_TYPE_AUCTION_PACKAGE.

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

string

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

Методы

get

 Получает один вариант таргетинга.

list

 Возвращает список настроек таргетинга заданного типа.
Поиск вариантов таргетинга определенного типа по заданным поисковым запросам.