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)
  }
  // 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 )

Подробная информация о жанровых особенностях контента.

Конец взаимоисключающих областей.

DigitalContentLabelTargetingOptionDetails

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

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

enum ( ContentRatingTier )

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

Подробная информация о параметрах таргетинга по конфиденциальным категориям

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

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

enum ( SensitiveCategory )

Только для вывода. Перечисление для классификатора контента категории "Конфиденциальный" DV360.

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 )

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

ContentInstreamPositionTargetingOptionDetails

Представляет собой позицию в потоке контента, которую можно использовать для показа видео- и аудиорекламы. Это значение будет заполнено в поле 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 )

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

Подробности варианта таргетинга по доходам домохозяйств

Представляет собой целевой уровень дохода домохозяйства. Это значение будет заполнено в поле 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

Представляет собой целевую точку интереса (POI). Это значение будет заполнено в поле poiDetails , если targetingType имеет значение TARGETING_TYPE_POI .

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

number

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

longitude

number

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

displayName

string

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

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

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

Методы

get

 Предоставляется единственный вариант прицеливания.

list

 Отображает список целевых параметров заданного типа.
Поиск целевых параметров заданного типа на основе заданных поисковых запросов.