REST Resource: targetingTypes.targetingOptions

Ресурс: TargetingOption

Представляет собой единый вариант таргетинга, который является таргетинговой концепцией в DV360.

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

  // Union field details can be only one of the following:
  "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 list of possible types for union field details.
}
Поля
name

string

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

targetingOptionId

string

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

targetingType

enum ( TargetingType )

Только вывод. Тип этого параметра таргетинга.

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

object ( DigitalContentLabelTargetingOptionDetails )

Подробная информация о маркировке цифрового контента.

sensitiveCategoryDetails

object ( SensitiveCategoryTargetingOptionDetails )

Подробности деликатной категории.

contentThemeDetails

object ( ContentThemeTargetingOptionDetails )

Подробности темы контента.

appCategoryDetails

object ( AppCategoryTargetingOptionDetails )

Подробная информация о категории приложения.

onScreenPositionDetails

object ( OnScreenPositionTargetingOptionDetails )

Подробная информация о местоположении на экране.

contentOutstreamPositionDetails

object ( ContentOutstreamPositionTargetingOptionDetails )

Подробная информация о позиции контента outstream.

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 )

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

audioContentTypeDetails

object ( AudioContentTypeTargetingOptionDetails )

Подробная информация о типе аудиоконтента.

contentGenreDetails

object ( ContentGenreTargetingOptionDetails )

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

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 )

Только вывод. Перечисление для классификатора контента категории «Конфиденциальная информация» 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

Представляет собой целевую позицию in-stream контента, которая может использоваться в видео- и аудиорекламе. Она будет указана в поле contentInstreamPositionDetails , если targetingType равен TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

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

enum ( ContentInstreamPosition )

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

ВидеоплеерРазмерТаргетингВариантПодробности

Представляет целевой размер видеоплеера. Будет указан в поле 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 )

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

РодительскийСтатусВариантНацеливанияПодробности

Представляет родительский статус, на который можно указать родительский статус. Он будет указан в поле 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 параметра «Таргетирование», если 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 )

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

Тип устройстваВариант таргетингаПодробности

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

Только вывод. Среда обслуживания.

ОперационнаяСистемаВариантНацеливанияПодробности

Представляет целевую операционную систему. Будет указано в поле 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

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

ВидимостьТаргетингВариантПодробности

Представляет целевую видимость. Будет заполнено полем viewabilityDetails параметра TargetingOption, если targetingType — TARGETING_TYPE_VIEWABILITY .

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

enum ( Viewability )

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

КатегорияТаргетингВариантПодробности

Представляет целевую категорию. Будет заполнено полем categoryDetails параметра TargetingOption, если targetingType — TARGETING_TYPE_CATEGORY .

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

string

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

ЯзыкВариантНацеливанияПодробности

Представляет целевой язык. Будет указан в поле languageDetails , если targetingType равно TARGETING_TYPE_LANGUAGE .

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

string

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

АвторизованныйПродавецСтатусВариантНацеливанияПодробности

Представляет собой таргетинг на статус авторизованного продавца. Он будет указан в поле 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 )

Только вывод. Тип обмена.

Подробные сведения о варианте таргетинга обмена

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

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

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 )

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

AudioContentTypeTargetingOptionDetails

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

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

enum ( AudioContentType )

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

СодержаниеЖанрТаргетингВариантПодробности

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

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

string

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

Методы

get

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

list

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