REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Поля
name

string

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

string

Только для вывода. Уникальный идентификатор назначенного варианта таргетинга. Идентификатор уникален только в пределах определенного ресурса и типа таргетинга. Его можно использовать в других контекстах.
assignedTargetingOptionIdAlias

string

Только для вывода. Псевдоним для assignedTargetingOptionId. Это значение можно использовать вместо assignedTargetingOptionId при получении или удалении существующего таргетинга.

Это поле будет поддерживаться только для всех назначенных параметров таргетинга следующих типов таргетинга:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Это поле также поддерживается для назначенных настроек таргетинга позиций следующих типов:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Только для вывода. Тип назначенного варианта таргетинга.
inheritance

enum (Inheritance)

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

object (ChannelAssignedTargetingOptionDetails)

Сведения о канале. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Сведения о категории приложения. Это поле будет заполнено, если targetingType – TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Сведения о приложении. Это поле будет заполнено, если targetingType – TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Информация о URL. Это поле будет заполнено, если targetingType – TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Сведения о дне и времени. Это поле будет заполнено, если targetingType – TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Сведения о возрастном диапазоне. Это поле будет заполнено, если targetingType – TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Сведения о региональном списке местоположений. Это поле будет заполнено, если targetingType – TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Сведения о списке местоположений в радиусе. Это поле будет заполнено, если targetingType – TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Сведения о поле. Это поле будет заполнено, если targetingType – TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Сведения о размере видеопроигрывателя. Это поле будет заполнено, если targetingType – TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

object (ParentalStatusAssignedTargetingOptionDetails)

Сведения о наличии детей. Это поле будет заполнено, если targetingType – TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Подробные сведения о позиции контента в видео. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Подробные сведения о позиции контента вне видеоконтента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Сведения о типе устройства. Это поле будет заполнено, если targetingType – TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

Сведения о браузере. Это поле будет заполнено, если targetingType – TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Сведения о семейном доходе. Это поле будет заполнено, если targetingType – TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Сведения о положении на экране. Это поле будет заполнено, если targetingType – TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Сведения об операторе связи и интернет-провайдере. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Сведения о ключевом слове. Это поле будет заполнено, если targetingType – TARGETING_TYPE_KEYWORD.

К ресурсу можно напрямую назначить не более 5000 минус-слов. Количество ключевых слов, которые можно назначить, не ограничено.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Сведения о ключевом слове. Это поле будет заполнено, если targetingType – TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Ресурсу можно назначить не более четырех списков минус-слов.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Сведения об операционной системе. Это поле будет заполнено, если targetingType – TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Сведения о марке и модели устройства. Это поле будет заполнено, если targetingType – TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Сведения о среде. Это поле будет заполнено, если targetingType – TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Сведения об источнике инвентаря. Это поле будет заполнено, если targetingType – TARGETING_TYPE_INVENTORY_SOURCE_DEAL.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Сведения о категории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CATEGORY.

При настройке таргетинга на категорию он также будет применяться к ее подкатегориям. Если категория исключена из таргетинга, а подкатегория включена, то приоритет будет у исключения.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Подробные сведения о видимости. Это поле будет заполнено, если targetingType – TARGETING_TYPE_VIEWABILITY.

Для каждого ресурса можно выбрать только один вариант видимости.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

Если у ресурса нет статуса авторизованного продавца, то по умолчанию таргетинг настраивается на всех авторизованных продавцов, которые указаны в файле ads.txt как DIRECT или RESELLER.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Сведения о языке. Это поле будет заполнено, если targetingType – TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Сведения о географическом регионе. Это поле будет заполнено, если targetingType – TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Сведения о группе источников инвентаря. Это поле будет заполнено, если targetingType – TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Подробные сведения о ярлыке цифрового контента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Ярлыки цифрового контента – это исключения таргетинга. Исключения ярлыков цифрового контента на уровне рекламодателя, если они заданы, всегда применяются при показе (даже если они не видны в настройках ресурса). В настройках ресурса можно исключить ярлыки контента в дополнение к исключениям рекламодателя, но нельзя переопределить их. Позиция не будет показываться, если исключены все ярлыки цифрового контента.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Сведения о деликатной категории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Деликатные категории – это исключения таргетинга. Исключения деликатных категорий на уровне рекламодателя, если они заданы, всегда применяются при показе (даже если они не видны в настройках ресурса). В настройках ресурса можно исключить деликатные категории в дополнение к исключениям рекламодателя, но нельзя переопределить их.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

Сведения о теме контента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Темы контента – это исключения таргетинга. Исключения тем контента на уровне рекламодателя, если они заданы, всегда применяются при показе (даже если они не видны в настройках ресурса). В настройках ресурса можно исключить тему контента в дополнение к исключениям рекламодателя.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Сведения об обмене. Это поле будет заполнено, если targetingType – TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Сведения о вспомогательном аукционе. Это поле будет заполнено, если targetingType – TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Сведения о сторонней проверке. Это поле будет заполнено, если targetingType – TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Сведения об объекте инфраструктуры. Это поле будет заполнено, если targetingType – TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Сведения о сети. Это поле будет заполнено, если targetingType – TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Сведения о длительности контента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Сведения о длительности контента. Это поле будет заполнено, если в поле TargetingType указано значение TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Сведения о позиции нативного контента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Сведения об инвентаре с поддержкой Open Measurement. Это поле будет заполнено, если targetingType – TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Сведения о типе аудиоконтента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Подробные сведения о жанре контента. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Сведения о видео на YouTube. Это поле будет заполнено, если targetingType – TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Сведения о канале YouTube. Это поле будет заполнено, если targetingType – TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Сведения о позиции сеанса. Это поле будет заполнено, если targetingType – TARGETING_TYPE_SESSION_POSITION.
lookalikeAudienceDetails

object (LookalikeAudienceAssignedTargetingOptionDetails)

Сведения о похожей аудитории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_LOOKALIKE_AUDIENCE.
googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

Сведения об аудитории Google. Это поле будет заполнено, если targetingType – TARGETING_TYPE_GOOGLE_AUDIENCE.
customListDetails

object (CustomListAssignedTargetingOptionDetails)

Сведения о списке клиентов. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CUSTOM_LIST.
combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

Сведения о смешанной аудитории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_COMBINED_AUDIENCE.
firstPartyAndPartnerAudienceDetails

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

Сведения о собственных аудиториях и аудиториях партнеров. Это поле будет заполнено, если targetingType – TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.
auctionPackageDetails

object (AuctionPackageAssignedTargetingOptionDetails)

Сведения о пакете для аукционов. Это поле заполняется, если значение поля targetingType – TARGETING_TYPE_AUCTION_PACKAGE.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Сведения о пакете каналов YouTube. Это поле будет заполнено, если targetingType – TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
Конец взаимоисключающих полей.

ChannelAssignedTargetingOptionDetails

Подробные сведения о варианте таргетинга на назначенный канал. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_CHANNEL.

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

string (int64 format)

Обязательно. Идентификатор канала. Должно ссылаться на поле идентификатора канала в ресурсе канала, принадлежащего партнеру, или канала, принадлежащего рекламодателю.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга. Для варианта таргетинга, назначенного на уровне рекламодателя, в этом поле должно быть указано значение true.

AppCategoryAssignedTargetingOptionDetails

Подробные сведения о варианте таргетинга на категорию приложения. Это значение будет указано в поле appCategoryDetails объекта AssignedTargetingOption, если значением поля targetingType является TARGETING_TYPE_APP_CATEGORY.

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

string

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_APP_CATEGORY.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

AppAssignedTargetingOptionDetails

Подробные сведения о назначенном варианте таргетинга на приложения. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_APP.

JSON-представление 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Поля
appId

string

Обязательно. Идентификатор приложения.

В Google Play для Android используется идентификатор пакета, например com.google.android.gm. Идентификатор приложения в Apple App Store состоит из девяти цифр, например 422689480.
displayName

string

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

boolean

Указывает, используется ли этот вариант для минус-таргетинга.
appPlatform

enum (AppPlatform)

Платформа целевого приложения. Если это поле не заполнено, считается, что приложение предназначено для мобильных устройств (т.е. Android или iOS), а мы определим подходящую мобильную платформу по идентификатору приложения.

AppPlatform

Возможные варианты таргетинга на платформы приложений.

Перечисления
APP_PLATFORM_UNSPECIFIED Значение по умолчанию, если платформа приложения не указана в этой версии. Это перечисление является плейсхолдером для значения по умолчанию и не представляет собой реальный вариант платформы.
APP_PLATFORM_IOS Платформа приложения – iOS.
APP_PLATFORM_ANDROID Платформа приложения – Android.
APP_PLATFORM_ROKU Платформа приложения – Roku.
APP_PLATFORM_AMAZON_FIRETV Платформа приложения – Amazon FireTV.
APP_PLATFORM_PLAYSTATION Платформа приложения – PlayStation.
APP_PLATFORM_APPLE_TV Платформа приложения – Apple TV.
APP_PLATFORM_XBOX Платформа приложения – Xbox.
APP_PLATFORM_SAMSUNG_TV Платформа приложения – Samsung TV.
APP_PLATFORM_ANDROID_TV Платформа приложения – Android TV.
APP_PLATFORM_GENERIC_CTV Платформа приложения – это платформа подключенного телевизора, которая не указана в других разделах.
APP_PLATFORM_LG_TV Платформа приложения – LG TV.
APP_PLATFORM_VIZIO_TV Платформа приложения – VIZIO TV.
APP_PLATFORM_VIDAA Платформа приложения – Vidaa.

UrlAssignedTargetingOptionDetails

Подробные сведения о назначенном варианте таргетинга на URL. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_URL.

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

string

Обязательно. URL, например example.com.

Дисплей и Видео 360 поддерживает таргетинг по подкаталогам двух уровней (например, www.example.com/one-subdirectory-level/second-level) и по субдоменам вплоть до пяти уровней (например, five.four.three.two.one.example.com).
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

DayAndTimeAssignedTargetingOptionDetails

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

JSON-представление 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Поля
dayOfWeek

enum (DayOfWeek)

Обязательно. День недели для этой настройки таргетинга по дням и времени.
startHour

integer

Обязательно. Час начала для таргетинга по дням и времени. Укажите значение от 0 (начало дня) до 23 (за час до конца дня).
endHour

integer

Обязательно. Час окончания таргетинга на дни и время. Значение должно быть в диапазоне от 1 (1 час после начала дня) до 24 (конец дня).
timeZoneResolution

enum (TimeZoneResolution)

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

Для позиций в кампаниях для создания спроса в этом поле всегда указано значение TIME_ZONE_RESOLUTION_ADVERTISER.

День недели

Представляет день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Tuesday (вторник)
WEDNESDAY Wednesday (среда)
THURSDAY Thursday (четверг)
FRIDAY Friday (пятница)
SATURDAY Saturday (суббота)
SUNDAY Воскресенье

TimeZoneResolution

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

Перечисления
TIME_ZONE_RESOLUTION_UNSPECIFIED Часовой пояс не указан или неизвестен.
TIME_ZONE_RESOLUTION_END_USER Время определяется по часовому поясу пользователя, который видел объявление.
TIME_ZONE_RESOLUTION_ADVERTISER Время указывается в часовом поясе рекламодателя, который показал объявление.

AgeRangeAssignedTargetingOptionDetails

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

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

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

Сведения о таргетинге для регионального списка местоположений. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_REGIONAL_LOCATION_LIST.

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

string (int64 format)

Обязательно. Идентификатор регионального списка местоположений. Должно ссылаться на поле locationListId ресурса LocationList, тип которого – TARGETING_LOCATION_TYPE_REGIONAL.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

ProximityLocationListAssignedTargetingOptionDetails

Сведения о таргетинге для списка местоположений в радиусе. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

JSON-представление 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Поля
proximityLocationListId

string (int64 format)

Обязательно. Идентификатор списка местоположений в радиусе. Должно ссылаться на поле locationListId ресурса LocationList типа TARGETING_LOCATION_TYPE_PROXIMITY.
proximityRadius

number

Обязательно. Радиус, выраженный в единицах измерения, заданных в proximityRadiusUnit. Размер области вокруг выбранного местоположения, на которую будет настроен таргетинг. Радиус должен составлять от 1 до 500 миль или 800 километров.
proximityRadiusUnit

enum (ProximityRadiusUnit)

Обязательно. Единицы измерения радиуса.

ProximityRadiusUnit

Перечисление единиц измерения расстояния для ProximityRadius.

Перечисления
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Значение по умолчанию, если в этой версии не указаны единицы измерения. Это перечисление является заполнителем для значения по умолчанию и не представляет реальную единицу измерения расстояния.
PROXIMITY_RADIUS_UNIT_MILES Единица измерения радиуса в милях.
PROXIMITY_RADIUS_UNIT_KILOMETERS Единица измерения радиуса в километрах

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

Обязательно. Пол аудитории.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

Обязательно. Размер видеопроигрывателя.

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_USER_REWARDED_CONTENT.
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

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

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

enum (ParentalStatus)

Обязательно. Наличие детей у аудитории.

ContentInstreamPositionAssignedTargetingOptionDetails

Подробные сведения о варианте таргетинга на позицию в видеоконтенте. Это значение будет указано в поле contentInstreamPositionDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

enum (ContentInstreamPosition)

Обязательно. Позиция видео- или аудиообъявления In-Stream в контенте.
adType

enum (AdType)

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

  • AD_TYPE_VIDEO, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Тип креатива, связанного с объявлениями.

Перечисления
AD_TYPE_UNSPECIFIED Тип объявления не указан или неизвестен в этой версии.
AD_TYPE_DISPLAY Медийные креативы, например графические и HTML5.
AD_TYPE_VIDEO Видеокреативы, например видеообъявления, которые воспроизводятся во время потоковой передачи контента в видеопроигрывателях.
AD_TYPE_AUDIO Аудиокреативы, например аудиообъявления, которые воспроизводятся во время прослушивания аудиоконтента.

ContentOutstreamPositionAssignedTargetingOptionDetails

Сведения о параметре таргетинга на позицию вне контента. Это значение будет указано в поле contentOutstreamPositionDetails, если значение поля targetingType – TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

enum (ContentOutstreamPosition)

Обязательно. Позиция контента Out-Stream.
adType

enum (AdType)

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

  • AD_TYPE_DISPLAY, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Сведения о таргетинге по типу устройства. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_DEVICE_TYPE.

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

enum (DeviceType)

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

number

Только для вывода. Мультипликатор ставок позволяет регулировать частоту показа рекламы для разных типов устройств. К исходной ставке будет применен множитель. Если в этом поле указан 0, это означает, что оно неприменимо, а не то, что исходная ставка умножается на 0.

Например, если ставка без множителя составляет 10 долларов США, а множитель для планшетов равен 1,5, то итоговая ставка для планшетов будет равна 15 долларам США.

Применимо только к позициям для YouTube и партнерских видеоресурсов.

AudienceGroupAssignedTargetingOptionDetails

Сведения о назначенном варианте таргетинга на группу аудиторий. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_AUDIENCE_GROUP. Отношение между группами – UNION (объединение), за исключением excludedFirstAndThirdPartyAudienceGroup и excludedGoogleAudienceGroup, для которых COMPLEMENT (дополнение) используется как INTERSECTION (пересечение) с другими группами.

JSON-представление 
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
Поля
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Необязательное поле. Идентификаторы сегментов аудитории Google, входящих в группу аудиторий Google. Содержит только идентификаторы сегментов аудитории Google.
includedCustomListGroup

object (CustomListGroup)

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

object (CombinedAudienceGroup)

Необязательное поле. Идентификаторы смешанных аудиторий, входящих в группу аудиторий. Содержит только идентификаторы смешанных аудиторий.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Необязательное поле. Идентификаторы исключенных сегментов аудитории Google. Используется для минус-таргетинга. ДОПОЛНЕНИЕ к ОБЪЕДИНЕНИЮ этой группы и других исключенных групп аудиторий используется как ПЕРЕСЕЧЕНИЕ с любым выбором целевой аудитории. Содержит только сегменты аудитории Google следующих типов: аудитории по интересам, аудитории заинтересованных покупателей и аудитории пользователей установленных приложений. Все элементы логически связаны оператором ИЛИ.
includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

Необязательное поле. Идентификаторы и давность собственных и партнерских аудиторий, включенных в группы аудиторий. Каждая группа собственных и партнерских аудиторий содержит только идентификаторы собственных и партнерских аудиторий. Отношение между каждой собственной и партнерской группой аудиторий – ПЕРЕСЕЧЕНИЕ, а результат ОБЪЕДИНЯЕТСЯ с другими группами аудиторий. Повторяющиеся группы с одинаковыми настройками будут игнорироваться.
excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

Необязательное поле. Идентификаторы и давность собственных и партнерских аудиторий, входящих в исключенную группу аудиторий. Используется для минус-таргетинга. ДОПОЛНЕНИЕ к ОБЪЕДИНЕНИЮ этой группы и других исключенных групп аудиторий используется как ПЕРЕСЕЧЕНИЕ с любым выбором целевой аудитории. Все элементы логически связаны оператором ИЛИ.

GoogleAudienceGroup

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

JSON-представление 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Поля
settings[]

object (GoogleAudienceTargetingSetting)

Обязательно. Все настройки таргетинга на аудитории Google в группе аудиторий Google. Повторяющиеся настройки с одинаковым идентификатором будут игнорироваться.

GoogleAudienceTargetingSetting

Подробные сведения о настройке таргетинга на аудитории Google.

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

string (int64 format)

Обязательно. Идентификатор сегмента аудитории Google в настройках выбора целевой аудитории. Идентификатор: googleAudienceId.

CustomListGroup

Сведения о группе специальных списков. Все настройки таргетинга на списки клиентов логически связаны оператором "ИЛИ".

JSON-представление 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Поля
settings[]

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

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

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

string (int64 format)

Обязательно. Пользовательский идентификатор настройки таргетинга на список клиентов. Идентификатор: customListId.

CombinedAudienceGroup

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

JSON-представление 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Поля
settings[]

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

Подробные сведения о настройке таргетинга на смешанную аудиторию.

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

string (int64 format)

Обязательно. Идентификатор смешанной аудитории в настройках выбора целевой аудитории. Идентификатор: combinedAudienceId.

FirstPartyAndPartnerAudienceGroup

Сведения о группе собственных аудиторий и аудиторий партнеров. Все настройки выбора целевой аудитории для собственных и партнерских аудиторий логически связаны оператором "ИЛИ".

JSON-представление 
{
  "settings": [
    {
      object (FirstPartyAndPartnerAudienceTargetingSetting)
    }
  ]
}
Поля
settings[]

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

Подробные сведения о настройках таргетинга на собственные аудитории и аудитории партнеров.

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

string (int64 format)

Обязательно. Идентификатор собственной аудитории или аудитории партнера, указанный в настройках выбора целевой аудитории. Идентификатор: firstPartyAndPartnerAudienceId.
recency

enum (Recency)

Обязательно. Давность настройки таргетинга на собственные аудитории и аудитории партнеров. Применимо только к собственным аудиториям. В остальных случаях игнорируется. Подробнее: https://support.google.com/displayvideo/answer/2949947#recency. Если значение не указано, ограничение по давности не применяется.

Давность

Все поддерживаемые значения времени с последнего посещения для собственных аудиторий и аудиторий партнеров.

Перечисления
RECENCY_NO_LIMIT Ограничений по давности нет.
RECENCY_1_MINUTE Давность – 1 минута.
RECENCY_5_MINUTES Давность – 5 минут.
RECENCY_10_MINUTES Давность – 10 минут.
RECENCY_15_MINUTES Давность – 15 минут.
RECENCY_30_MINUTES Давность – 30 минут.
RECENCY_1_HOUR Давность – 1 час.
RECENCY_2_HOURS Давность – 2 часа.
RECENCY_3_HOURS Давность – 3 часа.
RECENCY_6_HOURS Давность – 6 часов.
RECENCY_12_HOURS Давность – 12 часов.
RECENCY_1_DAY Давность посещения – 1 день.
RECENCY_2_DAYS Давность посещения – 2 дня.
RECENCY_3_DAYS Давность – 3 дня.
RECENCY_5_DAYS Давность – 5 дней.
RECENCY_7_DAYS Давность – 7 дней.
RECENCY_10_DAYS Давность – 10 дней.
RECENCY_14_DAYS Давность – 14 дней.
RECENCY_15_DAYS Давность – 15 дней.
RECENCY_21_DAYS Давность – 21 день.
RECENCY_28_DAYS Давность – 28 дней.
RECENCY_30_DAYS Давность – 30 дней.
RECENCY_40_DAYS Давность – 40 дней.
RECENCY_45_DAYS Давность – 45 дней.
RECENCY_60_DAYS Давность – 60 дней.
RECENCY_90_DAYS Давность – 90 дней.
RECENCY_120_DAYS Давность – 120 дней.
RECENCY_180_DAYS Давность составляет 180 дней.
RECENCY_270_DAYS Давность – 270 дней.
RECENCY_365_DAYS Давность – 365 дней.

BrowserAssignedTargetingOptionDetails

Подробная информация о варианте таргетинга на назначенный браузер. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_BROWSER.

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

string

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

string

Обязательно. targetingOptionId для TargetingOption типа TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

Сведения о назначенном варианте таргетинга на семейный доход. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Обязательно. Семейный доход аудитории.

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_ON_SCREEN_POSITION.
onScreenPosition

enum (OnScreenPosition)

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

enum (AdType)

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

  • AD_TYPE_DISPLAY, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, настройка будет унаследована новой позицией, если lineItemType – LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

Указывает, используется ли для этого варианта минус-таргетинг. Все назначенные варианты таргетинга на оператора связи и интернет-провайдера в одном ресурсе должны иметь одинаковое значение в этом поле.

KeywordAssignedTargetingOptionDetails

Подробные сведения о назначенном варианте таргетинга по ключевым словам. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_KEYWORD.

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

string

Обязательно. Ключевое слово, например car insurance.

Ключевое слово не может быть оскорбительным. Должен быть закодирован в UTF-8 и иметь максимальный размер 255 байт. Максимальное количество символов – 80. Максимальное количество слов – 10.
negative

boolean

Указывает, используется ли этот вариант для исключения таргетинга.
exemptedPolicyNames[]

string

Необязательное поле. Названия правил, из которых нужно исключить ключевое слово.

Если вы попытаетесь настроить таргетинг на ключевое слово, нарушающее правила, в сообщении об ошибке будет указано название правила. Укажите это название в поле, чтобы исключить целевое ключевое слово из правила.

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

NegativeKeywordListAssignedTargetingOptionDetails

Сведения о таргетинге для списка минус-слов. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

string (int64 format)

Обязательно. Идентификатор списка минус-слов. Должно ссылаться на поле negativeKeywordListId ресурса NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

Обязательно. Идентификатор варианта таргетинга, который указывается в поле targetingOptionId, если в поле targetingType задано значение TARGETING_TYPE_OPERATING_SYSTEM.
negative

boolean

Указывает, используется ли этот вариант для исключения таргетинга.

DeviceMakeModelAssignedTargetingOptionDetails

Сведения о назначенных вариантах таргетинга на производителя и модель устройства. Это значение будет указано в поле deviceMakeModelDetails, если значение поля targetingType – TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_DEVICE_MAKE_MODEL.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

EnvironmentAssignedTargetingOptionDetails

Сведения о назначенных настройках таргетинга на платформу. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Обязательно. Среда показа.

InventorySourceAssignedTargetingOptionDetails

Сведения о таргетинге для источника инвентаря. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_INVENTORY_SOURCE_DEAL.

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

string (int64 format)

Обязательно. Идентификатор источника инвентаря. Должно ссылаться на поле inventorySourceId ресурса InventorySource.

CategoryAssignedTargetingOptionDetails

Сведения о назначенных настройках тематического таргетинга. Это значение будет указано в поле categoryDetails, если значение поля targetingType – TARGETING_TYPE_CATEGORY.

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

string

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_CATEGORY.
negative

boolean

Указывает, используется ли этот вариант для исключения таргетинга.

ViewabilityAssignedTargetingOptionDetails

Сведения о назначенных настройках таргетинга на основе видимости. Это значение будет указано в поле viewabilityDetails объекта AssignedTargetingOption, если значением поля targetingType является TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

Статус авторизованного продавца. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Если для ресурса не задан параметр таргетинга TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, то используется вариант "Авторизованные прямые продавцы и реселлеры".

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

enum (AuthorizedSellerStatus)

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

string

Обязательно. targetingOptionId для TargetingOption типа TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Подробные сведения о назначенном варианте языкового таргетинга. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_LANGUAGE.

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

string

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_LANGUAGE.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга. Все назначенные варианты языкового таргетинга для одного ресурса должны иметь одинаковое значение в этом поле.

GeoRegionAssignedTargetingOptionDetails

Сведения о назначенном варианте таргетинга на географический регион. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_GEO_REGION.

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

string

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_GEO_REGION.
geoRegionType

enum (GeoRegionType)

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

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

InventorySourceGroupAssignedTargetingOptionDetails

Сведения о таргетинге для группы источников инвентаря. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

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

string (int64 format)

Обязательно. Идентификатор группы источников инвентаря. Должно ссылаться на поле inventorySourceGroupId ресурса InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Сведения о таргетинге на ярлыки цифрового контента. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

enum (ContentRatingTier)

Обязательно. Отображаемое название ярлыка цифрового контента, который нужно ИСКЛЮЧИТЬ.

В этом поле можно указать только значение CONTENT_RATING_TIER_UNRATED.

SensitiveCategoryAssignedTargetingOptionDetails

Сведения о таргетинге для деликатной категории. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

enum (SensitiveCategory)

Обязательно. Перечисление для деликатных категорий контента в Дисплее и Видео 360, которые должны быть исключены.

В этом поле можно использовать только следующие значения:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

ContentThemeAssignedTargetingOptionDetails

Сведения о таргетинге на тему контента. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

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

string

Обязательно. Идентификатор темы контента, которую нужно ИСКЛЮЧИТЬ.
contentTheme

enum (ContentTheme)

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

enum (ContentTheme)

Обязательно. Перечисление для темы контента DV360, которая классифицирована как EXCLUDED.

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

Обязательно. Перечисляемое значение для биржи.

SubExchangeAssignedTargetingOptionDetails

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

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Сведения о назначенном параметре таргетинга на сторонний инструмент проверки. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_THIRD_PARTY_VERIFIER.

JSON-представление 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  },
  "peer39": {
    object (Peer39)
  }
  // End of mutually exclusive fields.
}
Поля
Вы можете настроить таргетинг на один из сторонних партнеров по проверке, чтобы обеспечить безопасность бренда при показах. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
doubleVerify

object (DoubleVerify)

Сторонний инструмент проверки бренда – DoubleVerify.
integralAdScience

object (IntegralAdScience)

Сторонний инструмент проверки безопасности бренда – Integral Ad Science.
peer39

object (Peer39)

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

DoubleVerify

Подробные сведения о настройках DoubleVerify.

JSON-представление 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Поля
brandSafetyCategories

object (BrandSafetyCategories)

Настройки безопасности бренда DV.
avoidedAgeRatings[]

enum (AgeRating)

Не назначать ставки на приложения со следующим возрастным ограничением:
appStarRating

object (AppStarRating)

Не назначать ставки на приложения со следующими оценками:
displayViewability

object (DisplayViewability)

Настройки видимости медийной рекламы (применяются только к медийным позициям).
videoViewability

object (VideoViewability)

Настройки видимости видео (применяются только к видеопозициям).
fraudInvalidTraffic

object (FraudInvalidTraffic)

Исключить сайты и приложения со статистикой мошенничества и недействительного трафика
customSegmentId

string (int64 format)

Идентификатор особого сегмента, предоставленный DoubleVerify. Идентификатор должен начинаться с 51 и состоять из восьми цифр. Идентификатор особого сегмента нельзя указывать вместе со следующими полями:

BrandSafetyCategories

Настройки безопасности бренда.

JSON-представление 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Поля
avoidUnknownBrandSafetyCategory

boolean

Неизвестно или не подлежит оценке.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Категории, которые нежелательны с точки зрения безопасности бренда и имеют высокий уровень риска.
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

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

HighSeverityCategory

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

Перечисления
HIGHER_SEVERITY_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает на категории высокой степени серьезности.
ADULT_CONTENT_PORNOGRAPHY Контент для взрослых: порнография, нагота и темы, не предназначенные для несовершеннолетних.
COPYRIGHT_INFRINGEMENT Нарушение авторских прав.
SUBSTANCE_ABUSE Наркотики/алкоголь/контролируемые вещества: алкоголизм и наркомания.
GRAPHIC_VIOLENCE_WEAPONS Отталкивающие сцены/изображение насилия/оружие.
HATE_PROFANITY Дискриминационные высказывания/непристойная лексика.
CRIMINAL_SKILLS Незаконная деятельность: преступные навыки.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Искусственный трафик/вредоносное ПО/избыток рекламы.

MediumSeverityCategory

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

Перечисления
MEDIUM_SEVERITY_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает категории средней степени серьезности.
AD_SERVERS Серверы объявлений.
ADULT_CONTENT_SWIMSUIT Контент для взрослых: купальники.
ALTERNATIVE_LIFESTYLES Спорные темы: альтернативный образ жизни.
CELEBRITY_GOSSIP Спорные темы: светская хроника.
GAMBLING Спорные темы: азартные игры.
OCCULT Спорные темы: оккультизм.
SEX_EDUCATION Спорные темы: половое просвещение.
DISASTER_AVIATION Катастрофы: авиационные.
DISASTER_MAN_MADE Катастрофы: техногенные.
DISASTER_NATURAL Чрезвычайные происшествия: стихийные бедствия.
DISASTER_TERRORIST_EVENTS Чрезвычайные происшествия: террористические акты.
DISASTER_VEHICLE Чрезвычайные происшествия: транспортные аварии.
ALCOHOL Наркотики/алкоголь/контролируемые вещества: алкоголь.
SMOKING Наркотики/алкоголь/контролируемые вещества: курение.
NEGATIVE_NEWS_FINANCIAL Негативные новости: финансы.
NON_ENGLISH Нестандартный контент: не на английском языке.
PARKING_PAGE Нестандартный контент: страница-заглушка.
UNMODERATED_UGC Немодерируемый пользовательский контент: форумы, изображения и видео.
INFLAMMATORY_POLITICS_AND_NEWS Спорные темы: провокационные новости, в том числе о политике.
NEGATIVE_NEWS_PHARMACEUTICAL Негативные новости: лекарственные препараты.

AgeRating

Возможные варианты возрастных ограничений.

Перечисления
AGE_RATING_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает никаких вариантов возрастных ограничений.
APP_AGE_RATE_UNKNOWN Приложения с неизвестным возрастным ограничением.
APP_AGE_RATE_4_PLUS Приложения для всех (от 4 лет).
APP_AGE_RATE_9_PLUS Приложения для всех (от 9 лет).
APP_AGE_RATE_12_PLUS Приложения для подростков (от 12 лет).
APP_AGE_RATE_17_PLUS Приложения для подростков (от 17 лет).
APP_AGE_RATE_18_PLUS Приложения для взрослых (от 18 лет).

AppStarRating

Подробные сведения о настройках оценок DoubleVerify.

JSON-представление 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Поля
avoidedStarRating

enum (StarRating)

Не назначать ставки на приложения со следующими оценками:
avoidInsufficientStarRating

boolean

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

StarRating

Возможные варианты оценок.

Перечисления
APP_STAR_RATE_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает никаких вариантов оценки приложения.
APP_STAR_RATE_1_POINT_5_LESS Официальные приложения с рейтингом меньше 1,5 звезды.
APP_STAR_RATE_2_LESS Официальные приложения с рейтингом меньше 2 звезд.
APP_STAR_RATE_2_POINT_5_LESS Официальные приложения с рейтингом меньше 2,5 звезды.
APP_STAR_RATE_3_LESS Официальные приложения с рейтингом меньше 3 звезд.
APP_STAR_RATE_3_POINT_5_LESS Официальные приложения с рейтингом меньше 3,5 звезды.
APP_STAR_RATE_4_LESS Официальные приложения с рейтингом меньше 4 звезд.
APP_STAR_RATE_4_POINT_5_LESS "Official Apps with rating < 4.5 Stars" (Официальные приложения с рейтингом меньше 4,5 звезды).

DisplayViewability

Подробные сведения о настройках видимости медийной рекламы DoubleVerify.

JSON-представление 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Поля
iab

enum (IAB)

Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB.
viewableDuring

enum (ViewableDuring)

Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить длительность просмотра объявлений со 100-процентной видимостью.

IAB

Возможные варианты коэффициента видимости по стандартам IAB.

Перечисления
IAB_VIEWED_RATE_UNSPECIFIED Это перечисление является лишь заполнителем и не определяет никаких вариантов коэффициента просмотров IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 80% или выше.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 75% или выше.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 70% или выше.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 65% или выше.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 60% или выше.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 55% или выше.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 50% или выше.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 40% или выше.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 30% или выше.

ViewableDuring

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

Перечисления
AVERAGE_VIEW_DURATION_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает никаких вариантов средней продолжительности просмотра.
AVERAGE_VIEW_DURATION_5_SEC Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить длительность просмотра объявлений со 100-процентной видимостью в течение 5 секунд или более.
AVERAGE_VIEW_DURATION_10_SEC Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить длительность просмотра объявлений со 100-процентной видимостью в течение 10 секунд или более.
AVERAGE_VIEW_DURATION_15_SEC Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить длительность просмотра объявлений со 100-процентной видимостью в течение 15 секунд или более.

VideoViewability

Подробные сведения о настройках видимости видео в DoubleVerify.

JSON-представление 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Поля
videoIab

enum (VideoIAB)

Таргетинг на инвентарь сайтов с целью увеличить коэффициент видимости по стандартам IAB.
videoViewableRate

enum (VideoViewableRate)

Таргетинг на инвентарь сайтов с целью увеличить коэффициент видимости.
playerImpressionRate

enum (PlayerImpressionRate)

Таргетинг на инвентарь с целью увеличить количество показов в проигрывателях размера 400 x 300 или больше

VideoIAB

Возможные варианты коэффициента видимости по стандартам IAB.

Перечисления
VIDEO_IAB_UNSPECIFIED Это перечисление является лишь плейсхолдером и не определяет никаких вариантов коэффициента видимости видеорекламы по стандартам IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 80% или выше.
IAB_VIEWABILITY_75_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 75% или выше.
IAB_VIEWABILITY_70_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 70% или выше.
IAB_VIEWABILITY_65_PERCENT_HIHGER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 65% или выше.
IAB_VIEWABILITY_60_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 60% или выше.
IAB_VIEWABILITY_55_PERCENT_HIHGER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 55% или выше.
IAB_VIEWABILITY_50_PERCENT_HIGHER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 50% или выше.
IAB_VIEWABILITY_40_PERCENT_HIHGER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 40% или выше.
IAB_VIEWABILITY_30_PERCENT_HIHGER Таргетинг на инвентарь в приложениях и на сайтах с целью увеличить коэффициент видимости по стандартам IAB до 30% или выше.

VideoViewableRate

Возможные варианты коэффициента видимости.

Перечисления
VIDEO_VIEWABLE_RATE_UNSPECIFIED Это перечисление является лишь плейсхолдером и не определяет никаких вариантов коэффициента видимости видео.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Таргетинг на веб-инвентарь с целью увеличить коэффициент видимости до 40% или выше.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Таргетинг на веб-инвентарь с целью увеличить коэффициент видимости до 35% или выше.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Таргетинг на инвентарь сайтов с целью увеличить коэффициент видимости полностью видимых объявлений до 30% или выше.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Таргетинг на инвентарь сайтов с целью увеличить коэффициент видимости до 25% или выше.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Таргетинг на веб-инвентарь с целью увеличить коэффициент видимости до 20% или выше.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Таргетинг на инвентарь сайтов с целью увеличить коэффициент видимости полностью видимых объявлений на 10% или более.

PlayerImpressionRate

Возможные варианты показов.

Перечисления
PLAYER_SIZE_400X300_UNSPECIFIED Это перечисление является лишь заполнителем и не определяет никаких параметров показов.
PLAYER_SIZE_400X300_95 Сайты, на которых выполняется не менее 95%показов.
PLAYER_SIZE_400X300_70 Сайты, на которых выполняется не менее 70%показов.
PLAYER_SIZE_400X300_25 Сайты, на которых выполняется не менее 25%показов.
PLAYER_SIZE_400X300_5 Сайты, на которые приходится не менее 5%показов.

FraudInvalidTraffic

Настройки DoubleVerify для мошенничества и недействительного трафика.

JSON-представление 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Поля
avoidedFraudOption

enum (FraudOption)

Исключить сайты и приложения со статистикой мошенничества и недействительного трафика.
avoidInsufficientOption

boolean

Недостаточно статистики мошенничества и недействительного трафика.

FraudOption

Возможные варианты статистики мошенничества и недействительного трафика.

Перечисления
FRAUD_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает на какие-либо варианты мошенничества и недействительного трафика.
AD_IMPRESSION_FRAUD_100 Мошенничество и недействительный трафик: 100 %
AD_IMPRESSION_FRAUD_75 Доля мошеннических действий и недействительного трафика не менее 75 %.
AD_IMPRESSION_FRAUD_50 Доля мошеннических действий и недействительного трафика не менее 50 %
AD_IMPRESSION_FRAUD_25 Доля мошеннических действий и недействительного трафика не менее 25 %
AD_IMPRESSION_FRAUD_10 Доля мошеннических действий и недействительного трафика не менее 10 %
AD_IMPRESSION_FRAUD_8 Доля мошеннических действий и недействительного трафика не менее 8 %
AD_IMPRESSION_FRAUD_6 Доля мошеннических действий и недействительного трафика не менее 6 %
AD_IMPRESSION_FRAUD_4 Доля мошеннических действий и недействительного трафика не менее 4 %
AD_IMPRESSION_FRAUD_2 Доля мошеннических действий и недействительного трафика не менее 2 %

IntegralAdScience

Подробные сведения о настройках Integral Ad Science.

JSON-представление 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
Поля
traqScoreOption

enum (TRAQScore)

True Advertising Quality (только для медийных позиций).
excludeUnrateable

boolean

Безопасность бренда – не подлежит оценке.
excludedAdultRisk

enum (Adult)

Безопасность бренда – контент для взрослых.
excludedAlcoholRisk

enum (Alcohol)

Безопасность бренда – алкоголь.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Безопасность бренда – незаконные скачивания.
excludedDrugsRisk

enum (Drugs)

Безопасность бренда – наркотики.
excludedHateSpeechRisk

enum (HateSpeech)

Безопасность бренда – дискриминационные высказывания.
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Безопасность бренда – оскорбительные высказывания.
excludedViolenceRisk

enum (Violence)

Безопасность бренда – насилие.
excludedGamblingRisk

enum (Gambling)

Безопасность бренда – азартные игры.
excludedAdFraudRisk

enum (AdFraudPrevention)

Настройки мошенничества с рекламой.
displayViewability

enum (DisplayViewability)

Раздел "Видимость медийной рекламы" (только для позиций медийной рекламы).
videoViewability

enum (VideoViewability)

Раздел "Видимость видео" (только для видеопозиций).
customSegmentId[]

string (int64 format)

Идентификатор особого сегмента, предоставленный Integral Ad Science. Идентификатор должен быть в диапазоне от 1000001 до 1999999 или от 3000001 до 3999999 включительно.
qualitySyncCustomSegmentId[]

string (int64 format)

Необязательное поле. Идентификатор особого сегмента для синхронизации качества, предоставленный Integral Ad Science. Идентификатор должен быть в диапазоне от 3000000 до 4999999 включительно.

TRAQScore

Возможные диапазоны оценки TRAQ (True Advertising Quality) от Integral Ad Science.

Перечисления
TRAQ_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает на истинные показатели качества рекламы.
TRAQ_250 Оценка TRAQ: 250–1000.
TRAQ_500 Оценка TRAQ: 500–1000.
TRAQ_600 Оценка TRAQ: 600–1000.
TRAQ_700 Оценка TRAQ: 700–1000.
TRAQ_750 Оценка TRAQ 750–1000.
TRAQ_875 Оценка TRAQ: 875–1000.
TRAQ_1000 Оценка TRAQ: 1000.

Adult

Возможные варианты Integral Ad Science Adult.

Перечисления
ADULT_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает на какие-либо варианты для взрослых.
ADULT_HR Контент только для взрослых – исключить высокий уровень риска.
ADULT_HMR Контент только для взрослых – исключить высокий и умеренный уровни риска.

Алкоголь

Возможные варианты Integral Ad Science для алкоголя.

Перечисления
ALCOHOL_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает никаких вариантов алкоголя.
ALCOHOL_HR Алкоголь – исключить высокий уровень риска.
ALCOHOL_HMR Алкоголь – исключить высокий и умеренный уровни риска.

IllegalDownloads

Возможные варианты незаконного скачивания по классификации Integral Ad Science.

Перечисления
ILLEGAL_DOWNLOADS_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает на какие-либо варианты незаконного скачивания.
ILLEGAL_DOWNLOADS_HR Незаконные скачивания – исключить высокий уровень риска.
ILLEGAL_DOWNLOADS_HMR Незаконные скачивания – исключить высокий и умеренный уровни риска

Наркотики

Возможные варианты для категории "Наркотики" в Integral Ad Science.

Перечисления
DRUGS_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает никаких вариантов лекарств.
DRUGS_HR Наркотики – исключить высокий уровень риска.
DRUGS_HMR Наркотики – исключить высокий и умеренный уровни риска.

HateSpeech

Возможные варианты дискриминационных высказываний по классификации Integral Ad Science.

Перечисления
HATE_SPEECH_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает на какие-либо варианты дискриминационных высказываний.
HATE_SPEECH_HR Дискриминационные высказывания – исключить высокий уровень риска.
HATE_SPEECH_HMR Дискриминационные высказывания – исключить высокий и умеренный уровни риска.

OffensiveLanguage

Возможные варианты оскорбительных высказываний по классификации Integral Ad Science.

Перечисления
OFFENSIVE_LANGUAGE_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает никаких языковых параметров.
OFFENSIVE_LANGUAGE_HR Оскорбления – исключить высокий уровень риска.
OFFENSIVE_LANGUAGE_HMR Оскорбления – исключить высокий и умеренный уровни риска.

Насилие

Возможные варианты для параметра "Насилие" в Integral Ad Science.

Перечисления
VIOLENCE_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает на какие-либо варианты насилия.
VIOLENCE_HR Насилие – исключить высокий уровень риска.
VIOLENCE_HMR Насилие – исключить высокий и умеренный уровни риска.

Азартные игры

Возможные варианты Integral Ad Science Gambling.

Перечисления
GAMBLING_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает на какие-либо варианты азартных игр.
GAMBLING_HR Азартные игры – исключить высокий уровень риска.
GAMBLING_HMR Азартные игры – исключить высокий и умеренный уровни риска.

AdFraudPrevention

Возможные варианты предотвращения мошенничества с объявлениями Integral Ad Science.

Перечисления
SUSPICIOUS_ACTIVITY_UNSPECIFIED Это перечисление является лишь заполнителем и не указывает никаких вариантов предотвращения мошенничества с рекламой.
SUSPICIOUS_ACTIVITY_HR Мошенничество с рекламой – исключить высокий уровень риска.
SUSPICIOUS_ACTIVITY_HMR Мошенничество с рекламой – исключить высокий и умеренный уровни риска.
SUSPICIOUS_ACTIVITY_FD Мошенничество с рекламой – исключение устройств, использующихся в мошеннических целях.

DisplayViewability

Возможные варианты видимости медийной рекламы Integral Ad Science.

Перечисления
PERFORMANCE_VIEWABILITY_UNSPECIFIED Это перечисление является лишь заполнителем и не определяет никаких параметров видимости медийной рекламы.
PERFORMANCE_VIEWABILITY_40 Задайте целевую видимость на уровне 40% или выше.
PERFORMANCE_VIEWABILITY_50 Задайте целевую видимость на уровне 50% или выше.
PERFORMANCE_VIEWABILITY_60 Целевая видимость – 60% или выше.
PERFORMANCE_VIEWABILITY_70 Задайте целевую видимость на уровне 70% или выше.

VideoViewability

Возможные варианты видимости видеообъявлений Integral Ad Science.

Перечисления
VIDEO_VIEWABILITY_UNSPECIFIED Это перечисление является лишь заполнителем и не определяет никаких параметров видимости видео.
VIDEO_VIEWABILITY_40 не менее 40%в видимой области экрана (стандарт видимости видеорекламы IAB).
VIDEO_VIEWABILITY_50 не менее 50%площади объявления находится в видимой области экрана (стандарт видимости видеорекламы IAB);
VIDEO_VIEWABILITY_60 60%и более в видимой области экрана (стандарт видимости видеорекламы IAB).
VIDEO_VIEWABILITY_70 Более 70%показов в видимой области экрана (стандарт видимости видеорекламы IAB).

Peer39

Подробные сведения о настройках безопасности бренда в Peer39.

JSON-представление 
{
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
Поля
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

Необязательное поле. Категории Peer39, связанные с мошенничеством, недействительным трафиком и сайтами, созданными специально для AdSense, которые нужно исключить.
adultExplicitSexualContent

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для контента для взрослых и контента сексуального характера, которые нужно исключить.
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для контента, связанного с оружием и боеприпасами, которые нужно исключить.
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для контента, связанного со смертью, вредом здоровью или военными конфликтами, который нужно исключить.
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для интернет-пиратства, которые нужно исключить.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для непристойной лексики, которые нужно исключить.
spamHarmfulContent

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для спама или опасного контента, которые нужно исключить.
terrorismContent

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для террористического контента, которые нужно исключить.
misinformationContent

enum (GarmRiskExclusion)

Необязательное поле. Диапазоны риска GARM для ложной информации, которые нужно исключить.
displayIabViewability

enum (DisplayIabViewability)

Необязательное поле. Пороговое значение видимости медийных объявлений, установленное IAB.
videoIabViewability

enum (VideoIabViewability)

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

FraudIvtMfaCategory

Доступные категории Peer39 Fraud, IVT, MFA.

Перечисления
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Значение по умолчанию, когда категория Peer39 Fraud, IVT, MFA не указана или неизвестна в этой версии.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Доступные варианты исключения уровней риска GARM.

Перечисления
GARM_RISK_EXCLUSION_UNSPECIFIED Это перечисление является лишь плейсхолдером и не указывает на какой-либо вариант исключения риска GARM.
GARM_RISK_EXCLUSION_FLOOR Исключить минимальный уровень риска.
GARM_RISK_EXCLUSION_HIGH Исключить высокий и минимальный уровни риска.
GARM_RISK_EXCLUSION_MEDIUM Исключить риски среднего, высокого и основного уровня.
GARM_RISK_EXCLUSION_LOW Исключить риски любого уровня (низкого, среднего, высокого и минимального).

DisplayIabViewability

Доступные пороговые значения видимости медийной рекламы Peer39 IAB.

Перечисления
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Значение по умолчанию, если оно не указано или неизвестно в этой версии.
DISPLAY_IAB_VIEWABILITY_10 не менее 10%в видимой области экрана (стандарт видимости медийной рекламы IAB).
DISPLAY_IAB_VIEWABILITY_20 не менее 20%показов в видимой области экрана (стандарт IAB для медийной рекламы);
DISPLAY_IAB_VIEWABILITY_35 35%и более показов в видимой области экрана (стандарт видимости медийной рекламы IAB).
DISPLAY_IAB_VIEWABILITY_50 не менее 50%площади объявления находится в видимой области экрана (стандарт IAB для медийной рекламы);
DISPLAY_IAB_VIEWABILITY_75 не менее 75%показов в видимой области экрана (стандарт IAB для медийной рекламы).

VideoIabViewability

Доступные пороговые значения видимости видео Peer39 IAB.

Перечисления
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Значение по умолчанию, если оно не указано или неизвестно в этой версии.
VIDEO_IAB_VIEWABILITY_10 не менее 10%в видимой области экрана (стандарт видимости видеорекламы IAB).
VIDEO_IAB_VIEWABILITY_20 не менее 20%в видимой области экрана (стандарт видимости видеорекламы IAB).
VIDEO_IAB_VIEWABILITY_35 не менее 35%в видимой области экрана (стандарт видимости видеообъявлений IAB).
VIDEO_IAB_VIEWABILITY_50 не менее 50%площади объявления находится в видимой области экрана (стандарт видимости видеорекламы IAB);
VIDEO_IAB_VIEWABILITY_75 не менее 75%показов в видимой области экрана (стандарт видимости видеорекламы IAB).

PoiAssignedTargetingOptionDetails

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

JSON-представление 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Поля
displayName

string

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_POI.

Допустимые идентификаторы вариантов таргетинга на объекты инфраструктуры можно получить с помощью targetingTypes.targetingOptions.search.

Если вы хотите настроить таргетинг на определенные координаты широты и долготы, не связанные с адресом или названием объекта инфраструктуры, то можете создать идентификатор нужного варианта таргетинга. Для этого округлите значения координат до шестого знака после запятой, удалите десятичные знаки и объедините строковые значения, разделив их точкой с запятой. Например, чтобы настроить таргетинг на пару широты и долготы 40.7414691, -74.003387, используйте идентификатор варианта таргетинга "40741469;-74003387". При создании к значению этого поля будет добавлена точка с запятой и буквенно-цифровое значение хеша, если указаны только координаты широты и долготы.
latitude

number

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

number

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

number

Обязательно. Радиус области вокруг объекта инфраструктуры, на которую будет настроен таргетинг. Единицы измерения радиуса задаются в столбце proximityRadiusUnit. Должно быть от 1 до 800, если единица измерения – DISTANCE_UNIT_KILOMETERS, и от 1 до 500, если единица измерения – DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

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

DistanceUnit

Возможные варианты единиц измерения расстояния.

Перечисления
DISTANCE_UNIT_UNSPECIFIED Значение типа не указано или неизвестно в этой версии.
DISTANCE_UNIT_MILES Мили.
DISTANCE_UNIT_KILOMETERS Мили.

BusinessChainAssignedTargetingOptionDetails

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

JSON-представление 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Поля
displayName

string

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_BUSINESS_CHAIN.

Допустимые идентификаторы вариантов таргетинга на сетевые компании можно получить с помощью SearchTargetingOptions.
proximityRadiusAmount

number

Обязательно. Радиус области вокруг сетевой компании, на которую будет настроен таргетинг. Единицы измерения радиуса задаются в столбце proximityRadiusUnit. Должно быть от 1 до 800, если единица измерения – DISTANCE_UNIT_KILOMETERS, и от 1 до 500, если единица измерения – DISTANCE_UNIT_MILES. Минимальный шаг в обоих случаях – 0,1. Если значение слишком точное, оно будет округлено до ближайшего допустимого. Например, 15,57 превратится в 15,6.
proximityRadiusUnit

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

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

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_CONTENT_DURATION.
contentDuration

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

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

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_CONTENT_STREAM_TYPE.
contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

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

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

enum (NativeContentPosition)

Обязательно. Позиция контента.

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

Обязательно. Тип аудиоконтента.

ContentGenreAssignedTargetingOptionDetails

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

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

string

Обязательно. Поле targetingOptionId, если targetingType – TARGETING_TYPE_CONTENT_GENRE.
displayName

string

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

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

YoutubeVideoAssignedTargetingOptionDetails

Сведения о варианте таргетинга, назначенном для видео YouTube. Это значение будет указано в поле youtubeVideoDetails, если значение поля targetingType – TARGETING_TYPE_YOUTUBE_VIDEO.

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

string

Идентификатор видео YouTube, который указан на странице просмотра.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

YoutubeChannelAssignedTargetingOptionDetails

Подробные сведения о параметре таргетинга, назначенном каналу YouTube. Это значение будет указано в поле youtubeChannelDetails, если значение поля targetingType – TARGETING_TYPE_YOUTUBE_CHANNEL.

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

string

Идентификатор или код канала YouTube, на который загружено видео.
negative

boolean

Указывает, используется ли этот вариант для минус-таргетинга.

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

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

SessionPosition

Возможные позиции в сеансе.

Перечисления
SESSION_POSITION_UNSPECIFIED Это плейсхолдер, он не указывает на позиции.
SESSION_POSITION_FIRST_IMPRESSION Первый показ в сеансе.

LookalikeAudienceAssignedTargetingOptionDetails

Подробные сведения о таргетинге на похожие аудитории. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_LOOKALIKE_AUDIENCE.

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

string (int64 format)

Обязательно. Идентификатор похожей аудитории.
negative

boolean

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

GoogleAudienceAssignedTargetingOptionDetails

Подробные сведения о таргетинге на аудитории Google. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_GOOGLE_AUDIENCE.

JSON-представление 
{
  "googleAudienceId": string,
  "googleAudienceType": enum (GoogleAudienceType),
  "negative": boolean
}
Поля
googleAudienceId

string (int64 format)

Обязательно. Идентификатор сегмента аудитории Google.
googleAudienceType

enum (GoogleAudienceType)

Обязательно. Тип сегмента аудитории Google.
negative

boolean

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

CustomListAssignedTargetingOptionDetails

Подробная информация о таргетинге на списки клиентов. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_CUSTOM_LIST.

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

string (int64 format)

Обязательно. Идентификатор особого списка.
customListType

enum (CustomListType)

Обязательно. Тип особого списка.

CustomListType

Возможные типы списка клиентов.

Перечисления
CUSTOM_LIST_TYPE_UNSPECIFIED Значение по умолчанию, если тип не указан или неизвестен.
CUSTOM_LIST_TYPE_CUSTOM_AFFINITY Особый список клиентов по интересам.
CUSTOM_LIST_TYPE_CUSTOM_INTENT Особый список по намерениям.

CombinedAudienceAssignedTargetingOptionDetails

Подробные сведения о таргетинге на смешанные аудитории. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_COMBINED_AUDIENCE.

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

string (int64 format)

Обязательно. Идентификатор смешанной аудитории.

FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails

Подробные сведения о выборе целевой аудитории для собственных аудиторий и аудиторий партнеров. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.

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

string (int64 format)

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

boolean

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

AuctionPackageAssignedTargetingOptionDetails

Сведения о назначенном варианте таргетинга на пакет для аукционов. Это значение будет указано в поле details объекта AssignedTargetingOption, если значение targetingType равно TARGETING_TYPE_AUCTION_PACKAGE.

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

string

Обязательно. targetingOptionId TargetingOption типа TARGETING_TYPE_AUCTION_PACKAGE.
displayName

string

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

YoutubeChannelPackAssignedTargetingOptionDetails

Подробные сведения о назначенном таргетинге на пакет каналов YouTube. Это значение будет указано в поле youtubeChannelPackDetails, если значение поля targetingType – TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

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

string (int64 format)

Обязательно. Идентификатор пакета каналов YouTube.
negative

boolean

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

Наследование

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

Перечисления
INHERITANCE_UNSPECIFIED Наследование не указано или неизвестно.
NOT_INHERITED Назначенный параметр таргетинга не наследуется от объекта более высокого уровня.
INHERITED_FROM_PARTNER Назначенный вариант таргетинга наследуется из настроек таргетинга партнера.
INHERITED_FROM_ADVERTISER Назначенный вариант таргетинга наследуется из настроек таргетинга рекламодателя.

Методы

create

 Назначает вариант таргетинга группе объявлений.

delete

 Удаляет назначенный вариант таргетинга из группы объявлений.

get

 Возвращает один вариант таргетинга, назначенный группе объявлений.

list

 Список вариантов таргетинга, назначенных группе объявлений.