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)
  },
  "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 поля объединения. Подробная информация о параметрах таргетинга. Детально может быть заполнено только одно поле, и оно должно соответствовать типу targeting_type ; details могут быть только одним из следующих:
digitalContentLabelDetails

object ( DigitalContentLabelTargetingOptionDetails )

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

sensitiveCategoryDetails

object ( SensitiveCategoryTargetingOptionDetails )

Сведения о деликатной категории.

appCategoryDetails

object ( AppCategoryTargetingOptionDetails )

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

onScreenPositionDetails

object ( OnScreenPositionTargetingOptionDetails )

Детали положения на экране.

contentOutstreamPositionDetails

object ( ContentOutstreamPositionTargetingOptionDetails )

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

contentInstreamPositionDetails

object ( ContentInstreamPositionTargetingOptionDetails )

Сведения о позиции In-Stream контента.

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 )

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

SensitiveCategoryTargetingOptionDetails

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

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

enum ( SensitiveCategory )

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

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

Контентентинстримпозиционтаргетингвариантдетаилс

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

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

Вариант гендерного таргетингаПодробнее

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

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

Опция таргетинга браузераПодробнее

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

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

ОператорИспТип

Тип 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 )

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

Операционная системаTargetingOptionDetails

Представляет целевую операционную систему. Оно будет заполнено в поле operatingSystemDetails TargetingOption, если targetingType имеет значение TARGETING_TYPE_OPERATING_SYSTEM .

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

string

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

Девицемакемоделтаргетингоптииондетали

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

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

КатегорияТаргетингОпцияПодробнее

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

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

string

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

Языковой таргетингОпцияПодробности

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

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

PoiTargetingOptionПодробнее

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

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

number

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

longitude

number

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

displayName

string

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

BusinessChainTargetingOptionПодробнее

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

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

OmidTargetingOptionПодробности

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

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

ContentGenreTargetingOptionDetails

Представляет целевой жанр контента. Оно будет заполнено в поле contentGenreDetails , если targetingType имеет значение TARGETING_TYPE_CONTENT_GENRE .

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

string

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

Методы

get

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

list

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