REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

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

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

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

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

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

К ресурсу можно присвоить максимум 4 списка минус-слов.

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 .

categoryDetails

object ( CategoryAssignedTargetingOptionDetails )

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

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

viewabilityDetails

object ( ViewabilityAssignedTargetingOptionDetails )

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

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

authorizedSellerStatusDetails

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

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

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

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

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 )

Подробная информация о точке интереса (POI). Это поле будет заполнено, если 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 )

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

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

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

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

ChannelAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

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

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

displayName

string

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

negative

boolean

Указывает, подвергается ли данный вариант негативной критике.

appPlatform

enum ( AppPlatform )

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

Платформа приложений

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

Перечисления
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 Это платформа для мобильных приложений, ориентированная на CTV, которая не указана в других источниках.
APP_PLATFORM_LG_TV Приложение используется на платформе LG TV.
APP_PLATFORM_VIZIO_TV Приложение используется на платформе VIZIO TV.
APP_PLATFORM_VIDAA Платформа для приложений — Vidaa.

UrlAssignedTargetingOptionDetails

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

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

string

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

DV360 поддерживает два уровня таргетинга по подкаталогам, например, 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 (за 1 час до конца дня).

endHour

integer

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

timeZoneResolution

enum ( TimeZoneResolution )

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

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

День недели

Обозначает день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

Разрешение часового пояса

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

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

AgeRangeAssignedTargetingOptionDetails

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

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

enum ( AgeRange )

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

RegionalLocationListAssignedTargetingOptionDetails

Информация о таргетинге для списка региональных местоположений. Эта информация будет заполнена в поле сведений объекта 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

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

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

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

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

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

GenderAssignedTargetingOptionDetails

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

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

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

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 )

Обязательно. Позиция исходящего контента.

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,0 долларов, а множитель равен 1,5 для планшета, то итоговая цена предложения для планшета составит 15,0 долларов.

Применимо только к позициям в каталоге YouTube и партнеров.

AudienceGroupAssignedTargetingOptionDetails

Подробная информация о параметрах таргетинга для назначенных групп аудитории. Эта информация будет заполнена в поле "Подробности" объекта 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. Используется для отрицательного таргетинга. Дополнение к объединению этой группы и других исключенных групп аудитории используется в качестве пересечения для любого положительного таргетинга аудитории. Содержит только аудитории Google типов «Affinity», «In-market» и «Installed-apps». Все элементы логически являются операциями «ИЛИ» друг с другом.

includedFirstPartyAndPartnerAudienceGroups[]

object ( FirstPartyAndPartnerAudienceGroup )

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

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 из настроек таргетинга аудитории Google. Этот идентификатор — googleAudienceId .

CustomListGroup

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

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

object ( CustomListTargetingSetting )

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

CustomListTargetingSetting

Подробности настроек таргетинга по пользовательским спискам.

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

string ( int64 format)

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

Объединенная группа аудитории

Подробная информация об объединенной группе аудитории. Все параметры таргетинга объединенной аудитории логически являются операциями «ИЛИ» друг с другом.

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 )

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

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

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

string

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

targetingOptionId

string

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

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

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

Указание целевого источника запасов. Это поле будет заполнено в поле сведений объекта AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_INVENTORY_SOURCE .

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

string ( int64 format)

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

CategoryAssignedTargetingOptionDetails

Assigned category targeting option details. This will be populated in the categoryDetails field when targetingType is TARGETING_TYPE_CATEGORY .

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

string

Output only. The display name of the category.

targetingOptionId

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CATEGORY .

negative

boolean

Indicates if this option is being negatively targeted.

ViewabilityAssignedTargetingOptionDetails

Assigned viewability targeting option details. This will be populated in the viewabilityDetails field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_VIEWABILITY .

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

enum ( Viewability )

Required. The predicted viewability percentage.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

If a resource does not have an TARGETING_TYPE_AUTHORIZED_SELLER_STATUS assigned targeting option, it is using the "Authorized Direct Sellers and Resellers" option.

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

enum ( AuthorizedSellerStatus )

Output only. The authorized seller status to target.

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

LanguageAssignedTargetingOptionDetails

Details for assigned language targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_LANGUAGE .

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

string

Output only. The display name of the language (eg, "French").

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_LANGUAGE .

negative

boolean

Indicates if this option is being negatively targeted. All assigned language targeting options on the same resource must have the same value for this field.

GeoRegionAssignedTargetingOptionDetails

Details for assigned geographic region targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_GEO_REGION .

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

string

Output only. The display name of the geographic region (eg, "Ontario, Canada").

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_GEO_REGION .

geoRegionType

enum ( GeoRegionType )

Output only. The type of geographic region targeting.

negative

boolean

Indicates if this option is being negatively targeted.

InventorySourceGroupAssignedTargetingOptionDetails

Targeting details for inventory source group. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_INVENTORY_SOURCE_GROUP .

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

string ( int64 format)

Required. ID of the inventory source group. Should refer to the inventorySourceGroupId field of an InventorySourceGroup resource.

DigitalContentLabelAssignedTargetingOptionDetails

Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION .

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

enum ( ContentRatingTier )

Required. The display name of the digital content label rating tier to be EXCLUDED.

SensitiveCategoryAssignedTargetingOptionDetails

Targeting details for sensitive category. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

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

enum ( SensitiveCategory )

Required. An enum for the DV360 Sensitive category content classified to be EXCLUDED.

ContentThemeAssignedTargetingOptionDetails

Targeting details for content theme. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_CONTENT_THEME_EXCLUSION .

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

string

Required. ID of the content theme to be EXCLUDED.

contentTheme

enum ( ContentTheme )

Output only. An enum for the DV360 content theme classifier.

excludedContentTheme

enum ( ContentTheme )

Required. An enum for the DV360 content theme classified to be EXCLUDED.

ExchangeAssignedTargetingOptionDetails

Details for assigned exchange targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_EXCHANGE .

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

enum ( Exchange )

Required. The enum value for the exchange.

SubExchangeAssignedTargetingOptionDetails

Details for assigned sub-exchange targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_SUB_EXCHANGE .

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

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_SUB_EXCHANGE .

ThirdPartyVerifierAssignedTargetingOptionDetails

Assigned third party verifier targeting option details. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_THIRD_PARTY_VERIFIER .

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

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Поля
Union field verifier . Can target one of third-party verifier to enforce brand safety thresholds for impressions. verifier can be only one of the following:
adloox

object ( Adloox )

Third party brand verifier -- Scope3 (previously known as Adloox).

doubleVerify

object ( DoubleVerify )

Third party brand verifier -- DoubleVerify.

integralAdScience

object ( IntegralAdScience )

Third party brand verifier -- Integral Ad Science.

Adloox

Details of Scope3 (previously known as Adloox) brand safety settings.

JSON-представление 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "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)
}
Поля
excludedAdlooxCategories[]

enum ( AdlooxCategory )

Scope3 categories to exclude.

excludedFraudIvtMfaCategories[]

enum ( FraudIvtMfaCategory )

Optional. Scope3's fraud IVT MFA categories to exclude.

adultExplicitSexualContent

enum ( GarmRiskExclusion )

Optional. Adult and Explicit Sexual Content GARM risk ranges to exclude.

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum ( GarmRiskExclusion )

Optional. Crime and Harmful Acts Content GARM risk ranges to exclude.

armsAmmunitionContent

enum ( GarmRiskExclusion )

Optional. Arms and Ammunition Content GARM risk ranges to exclude.

deathInjuryMilitaryConflictContent

enum ( GarmRiskExclusion )

Optional. Death, Injury, or Military Conflict Content GARM risk ranges to exclude.

debatedSensitiveSocialIssueContent

enum ( GarmRiskExclusion )

Optional. Debated Sensitive Social Issue Content GARM risk ranges to exclude.

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum ( GarmRiskExclusion )

Optional. Illegal Drugs/Alcohol Content GARM risk ranges to exclude.

onlinePiracyContent

enum ( GarmRiskExclusion )

Optional. Online Piracy Content GARM risk ranges to exclude.

hateSpeechActsAggressionContent

enum ( GarmRiskExclusion )

Optional. Hate Speech and Acts of Aggression Content GARM risk ranges to exclude.

obscenityProfanityContent

enum ( GarmRiskExclusion )

Optional. Obscenity and Profanity Content GARM risk ranges to exclude.

spamHarmfulContent

enum ( GarmRiskExclusion )

Optional. Spam or Harmful Content GARM risk ranges to exclude.

terrorismContent

enum ( GarmRiskExclusion )

Optional. Terrorism Content GARM risk ranges to exclude.

misinformationContent

enum ( GarmRiskExclusion )

Optional. Misinformation Content GARM risk ranges to exclude.

displayIabViewability

enum ( DisplayIabViewability )

Optional. IAB viewability threshold for display ads.

videoIabViewability

enum ( VideoIabViewability )

Optional. IAB viewability threshold for video ads.

AdlooxCategory

Available Scope3 (previously known as Adloox) categories.

Перечисления
ADLOOX_UNSPECIFIED Default value when a Scope3 category is not specified or is unknown in this version.
ADULT_CONTENT_HARD Adult content (hard).
ADULT_CONTENT_SOFT Adult content (soft).
ILLEGAL_CONTENT Illegal content.
BORDERLINE_CONTENT Borderline content.
DISCRIMINATORY_CONTENT Discriminatory content.
VIOLENT_CONTENT_WEAPONS Violent content & weapons.
LOW_VIEWABILITY_DOMAINS Low viewability domains.
FRAUD Мошенничество.

FraudIvtMfaCategory

Available Scope3 (previously known as Adloox) Fraud, IVT, MFA categories.

Перечисления
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Default value when a Scope3 Fraud, IVT, MFA category is not specified or is unknown in this version.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Available GARM risk level exclusion options.

Перечисления
GARM_RISK_EXCLUSION_UNSPECIFIED This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.
GARM_RISK_EXCLUSION_FLOOR Exclude floor risk.
GARM_RISK_EXCLUSION_HIGH Exclude high and floor risk.
GARM_RISK_EXCLUSION_MEDIUM Exclude medium, high, and floor risk.
GARM_RISK_EXCLUSION_LOW Exclude all levels of risk (low, medium, high and floor).

DisplayIabViewability

Available Scope3 (previously known as Adloox) IAB display viewability thresholds.

Перечисления
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Default value when not specified or is unknown in this version.
DISPLAY_IAB_VIEWABILITY_10 10%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_20 20%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_35 35%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_50 50%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_75 75%+ in view (IAB display viewability standard).

VideoIabViewability

Available Scope3 (previously known as Adloox) IAB video viewability thresholds.

Перечисления
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Default value when not specified or is unknown in this version.
VIDEO_IAB_VIEWABILITY_10 10%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_20 20%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_35 35%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_50 50%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_75 75%+ in view (IAB video viewability standard).

DoubleVerify

Details of DoubleVerify settings.

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 Brand Safety Controls.

avoidedAgeRatings[]

enum ( AgeRating )

Avoid bidding on apps with the age rating.

appStarRating

object ( AppStarRating )

Avoid bidding on apps with the star ratings.

displayViewability

object ( DisplayViewability )

Display viewability settings (applicable to display line items only).

videoViewability

object ( VideoViewability )

Video viewability settings (applicable to video line items only).

fraudInvalidTraffic

object ( FraudInvalidTraffic )

Avoid Sites and Apps with historical Fraud & IVT Rates.

customSegmentId

string ( int64 format)

The custom segment ID provided by DoubleVerify. The ID must start with "51" and consist of eight digits. Custom segment ID cannot be specified along with any of the following fields:

BrandSafetyCategories

Settings for brand safety controls.

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

boolean

Unknown or unrateable.

avoidedHighSeverityCategories[]

enum ( HighSeverityCategory )

Brand safety high severity avoidance categories.

avoidedMediumSeverityCategories[]

enum ( MediumSeverityCategory )

Brand safety medium severity avoidance categories.

HighSeverityCategory

Possible options for high severity categories.

Перечисления
HIGHER_SEVERITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any high severity categories.
ADULT_CONTENT_PORNOGRAPHY Adult Content: Pornography, Mature Topics & Nudity.
COPYRIGHT_INFRINGEMENT Нарушение авторских прав.
SUBSTANCE_ABUSE Drugs/Alcohol/Controlled Substances: Substance Abuse.
GRAPHIC_VIOLENCE_WEAPONS Extreme Graphic/Explicit Violence/Weapons.
HATE_PROFANITY Hate/Profanity.
CRIMINAL_SKILLS Illegal Activities: Criminal Skills.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivized/Malware/Clutter.

MediumSeverityCategory

Possible options for medium severity categories.

Перечисления
MEDIUM_SEVERITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any medium severity categories.
AD_SERVERS Ad Servers.
ADULT_CONTENT_SWIMSUIT Adult Content: Swimsuit.
ALTERNATIVE_LIFESTYLES Controversial Subjects: Alternative Lifestyles.
CELEBRITY_GOSSIP Controversial Subjects: Celebrity Gossip.
GAMBLING Controversial Subjects: Gambling.
OCCULT Controversial Subjects: Occult.
SEX_EDUCATION Controversial Subjects: Sex Education.
DISASTER_AVIATION Disaster: Aviation.
DISASTER_MAN_MADE Disaster: Man-made.
DISASTER_NATURAL Disaster: Natural.
DISASTER_TERRORIST_EVENTS Disaster: Terrorist Events.
DISASTER_VEHICLE Disaster: Vehicle.
ALCOHOL Drugs/Alcohol/Controlled Substances: Alcohol.
SMOKING Drugs/Alcohol/Controlled Substances: Smoking.
NEGATIVE_NEWS_FINANCIAL Negative News: Financial.
NON_ENGLISH Non-Std Content: Non-English.
PARKING_PAGE Non-Std Content: Parking Page.
UNMODERATED_UGC Unmoderated UGC: Forums, Images & Video.
INFLAMMATORY_POLITICS_AND_NEWS Controversial Subjects: Inflammatory Politics and News.
NEGATIVE_NEWS_PHARMACEUTICAL Negative News: Pharmaceutical.

AgeRating

Possible options for age ratings.

Перечисления
AGE_RATING_UNSPECIFIED This enum is only a placeholder and it doesn't specify any age rating options.
APP_AGE_RATE_UNKNOWN Apps with unknown age rating.
APP_AGE_RATE_4_PLUS Apps rated for Everyone (4+).
APP_AGE_RATE_9_PLUS Apps rated for Everyone (9+).
APP_AGE_RATE_12_PLUS Apps rated for Teens (12+).
APP_AGE_RATE_17_PLUS Apps rated for Mature (17+).
APP_AGE_RATE_18_PLUS Apps rated for Adults Only (18+).

AppStarRating

Details of DoubleVerify star ratings settings.

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

enum ( StarRating )

Avoid bidding on apps with the star ratings.

avoidInsufficientStarRating

boolean

Avoid bidding on apps with insufficient star ratings.

StarRating

Possible options for star ratings.

Перечисления
APP_STAR_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any app star rating options.
APP_STAR_RATE_1_POINT_5_LESS Official Apps with rating < 1.5 Stars.
APP_STAR_RATE_2_LESS Official Apps with rating < 2 Stars.
APP_STAR_RATE_2_POINT_5_LESS Official Apps with rating < 2.5 Stars.
APP_STAR_RATE_3_LESS Official Apps with rating < 3 Stars.
APP_STAR_RATE_3_POINT_5_LESS Official Apps with rating < 3.5 Stars.
APP_STAR_RATE_4_LESS Official Apps with rating < 4 Stars.
APP_STAR_RATE_4_POINT_5_LESS Official Apps with rating < 4.5 Stars.

DisplayViewability

Details of DoubleVerify display viewability settings.

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

enum ( IAB )

Target web and app inventory to maximize IAB viewable rate.

viewableDuring

enum ( ViewableDuring )

Target web and app inventory to maximize 100% viewable duration.

IAB

Possible options for IAB viewable rate.

Перечисления
IAB_VIEWED_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any IAB viewed rate options.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 80% or higher.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 75% or higher.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 70% or higher.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 65% or higher.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 60% or higher.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 55% or higher.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 50% or higher.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 40% or higher.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 30% or higher.

ViewableDuring

Possible options for viewable duration.

Перечисления
AVERAGE_VIEW_DURATION_UNSPECIFIED This enum is only a placeholder and it doesn't specify any average view duration options.
AVERAGE_VIEW_DURATION_5_SEC Target web and app inventory to maximize 100% viewable duration 5 seconds or more.
AVERAGE_VIEW_DURATION_10_SEC Target web and app inventory to maximize 100% viewable duration 10 seconds or more.
AVERAGE_VIEW_DURATION_15_SEC Target web and app inventory to maximize 100% viewable duration 15 seconds or more.

VideoViewability

Details of DoubleVerify video viewability settings.

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

enum ( VideoIAB )

Target web inventory to maximize IAB viewable rate.

videoViewableRate

enum ( VideoViewableRate )

Target web inventory to maximize fully viewable rate.

playerImpressionRate

enum ( PlayerImpressionRate )

Target inventory to maximize impressions with 400x300 or greater player size.

VideoIAB

Possible options of IAB viewable rate.

Перечисления
VIDEO_IAB_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video IAB viewable rate options.
IAB_VIEWABILITY_80_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 80% or higher.
IAB_VIEWABILITY_75_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 75% or higher.
IAB_VIEWABILITY_70_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 70% or higher.
IAB_VIEWABILITY_65_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 65% or higher.
IAB_VIEWABILITY_60_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 60% or higher.
IAB_VIEWABILITY_55_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 55% or higher.
IAB_VIEWABILITY_50_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 50% or higher.
IAB_VIEWABILITY_40_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 40% or higher.
IAB_VIEWABILITY_30_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 30% or higher.

VideoViewableRate

Possible options of fully viewable rate.

Перечисления
VIDEO_VIEWABLE_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video viewable rate options.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 40% or higher.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 35% or higher.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 30% or higher.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 25% or higher.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 20% or higher.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 10% or higher.

PlayerImpressionRate

Possible options of impressions.

Перечисления
PLAYER_SIZE_400X300_UNSPECIFIED This enum is only a placeholder and it doesn't specify any impressions options.
PLAYER_SIZE_400X300_95 Sites with 95%+ of impressions.
PLAYER_SIZE_400X300_70 Sites with 70%+ of impressions.
PLAYER_SIZE_400X300_25 Sites with 25%+ of impressions.
PLAYER_SIZE_400X300_5 Sites with 5%+ of impressions.

FraudInvalidTraffic

DoubleVerify Fraud & Invalid Traffic settings.

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

enum ( FraudOption )

Avoid Sites and Apps with historical Fraud & IVT.

avoidInsufficientOption

boolean

Insufficient Historical Fraud & IVT Stats.

FraudOption

Possible options of historical Fraud & IVT rate.

Перечисления
FRAUD_UNSPECIFIED This enum is only a placeholder and it doesn't specify any fraud and invalid traffic options.
AD_IMPRESSION_FRAUD_100 100% Fraud & IVT.
AD_IMPRESSION_FRAUD_50 50% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_25 25% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_10 10% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_8 8% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_6 6% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_4 4% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_2 2% or Higher Fraud & IVT.

IntegralAdScience

Details of Integral Ad Science settings.

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 (applicable to Display line items only).

excludeUnrateable

boolean

Brand Safety - Unrateable .

excludedAdultRisk

enum ( Adult )

Brand Safety - Adult content .

excludedAlcoholRisk

enum ( Alcohol )

Brand Safety - Alcohol .

excludedIllegalDownloadsRisk

enum ( IllegalDownloads )

Brand Safety - Illegal downloads .

excludedDrugsRisk

enum ( Drugs )

Brand Safety - Drugs .

excludedHateSpeechRisk

enum ( HateSpeech )

Brand Safety - Hate speech .

excludedOffensiveLanguageRisk

enum ( OffensiveLanguage )

Brand Safety - Offensive language .

excludedViolenceRisk

enum ( Violence )

Brand Safety - Violence .

excludedGamblingRisk

enum ( Gambling )

Brand Safety - Gambling .

excludedAdFraudRisk

enum ( AdFraudPrevention )

Ad Fraud settings.

displayViewability

enum ( DisplayViewability )

Display Viewability section (applicable to display line items only).

videoViewability

enum ( VideoViewability )

Video Viewability Section (applicable to video line items only).

customSegmentId[]

string ( int64 format)

The custom segment ID provided by Integral Ad Science. The ID must be between 1000001 and 1999999 or 3000001 and 3999999 , inclusive.

qualitySyncCustomSegmentId[]

string ( int64 format)

Optional. The quality sync custom segment ID provided by Integral Ad Science. The ID must be between 3000000 and 4999999 , inclusive.

TRAQScore

Possible Integral Ad Science TRAQ (true advertising quality) score ranges.

Перечисления
TRAQ_UNSPECIFIED This enum is only a placeholder and it doesn't specify any true advertising quality scores.
TRAQ_250 TRAQ score 250-1000.
TRAQ_500 TRAQ score 500-1000.
TRAQ_600 TRAQ score 600-1000.
TRAQ_700 TRAQ score 700-1000.
TRAQ_750 TRAQ score 750-1000.
TRAQ_875 TRAQ score 875-1000.
TRAQ_1000 TRAQ score 1000.

Взрослый

Possible Integral Ad Science Adult options.

Перечисления
ADULT_UNSPECIFIED This enum is only a placeholder and it doesn't specify any adult options.
ADULT_HR Adult - Exclude High Risk.
ADULT_HMR Adult - Exclude High and Moderate Risk.

Алкоголь

Possible Integral Ad Science Alcohol options.

Перечисления
ALCOHOL_UNSPECIFIED This enum is only a placeholder and it doesn't specify any alcohol options.
ALCOHOL_HR Alcohol - Exclude High Risk.
ALCOHOL_HMR Alcohol - Exclude High and Moderate Risk.

IllegalDownloads

Possible Integral Ad Science Illegal downloads options.

Перечисления
ILLEGAL_DOWNLOADS_UNSPECIFIED This enum is only a placeholder and it doesn't specify any illegal downloads options.
ILLEGAL_DOWNLOADS_HR Illegal Downloads - Exclude High Risk.
ILLEGAL_DOWNLOADS_HMR Illegal Downloads - Exclude High and Moderate Risk.

Наркотики

Possible Integral Ad Science Drugs options.

Перечисления
DRUGS_UNSPECIFIED This enum is only a placeholder and it doesn't specify any drugs options.
DRUGS_HR Drugs - Exclude High Risk.
DRUGS_HMR Drugs - Exclude High and Moderate Risk.

HateSpeech

Possible Integral Ad Science Hate speech options.

Перечисления
HATE_SPEECH_UNSPECIFIED This enum is only a placeholder and it doesn't specify any hate speech options.
HATE_SPEECH_HR Hate Speech - Exclude High Risk.
HATE_SPEECH_HMR Hate Speech - Exclude High and Moderate Risk.

OffensiveLanguage

Possible Integral Ad Science Offensive language options.

Перечисления
OFFENSIVE_LANGUAGE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any language options.
OFFENSIVE_LANGUAGE_HR Offensive Language - Exclude High Risk.
OFFENSIVE_LANGUAGE_HMR Offensive Language - Exclude High and Moderate Risk.

Насилие

Possible Integral Ad Science Violence options.

Перечисления
VIOLENCE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any violence options.
VIOLENCE_HR Violence - Exclude High Risk.
VIOLENCE_HMR Violence - Exclude High and Moderate Risk.

Играть в азартные игры

Possible Integral Ad Science Gambling options.

Перечисления
GAMBLING_UNSPECIFIED This enum is only a placeholder and it doesn't specify any gambling options.
GAMBLING_HR Gambling - Exclude High Risk.
GAMBLING_HMR Gambling - Exclude High and Moderate Risk.

AdFraudPrevention

Possible Integral Ad Science Ad fraud prevention options.

Перечисления
SUSPICIOUS_ACTIVITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any ad fraud prevention options.
SUSPICIOUS_ACTIVITY_HR Ad Fraud - Exclude High Risk.
SUSPICIOUS_ACTIVITY_HMR Ad Fraud - Exclude High and Moderate Risk.
SUSPICIOUS_ACTIVITY_FD Ad Fraud - Exclude Fraudulent Device.

DisplayViewability

Possible Integral Ad Science Display viewability options.

Перечисления
PERFORMANCE_VIEWABILITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any display viewability options.
PERFORMANCE_VIEWABILITY_40 Target 40% Viewability or Higher.
PERFORMANCE_VIEWABILITY_50 Target 50% Viewability or Higher.
PERFORMANCE_VIEWABILITY_60 Target 60% Viewability or Higher.
PERFORMANCE_VIEWABILITY_70 Target 70% Viewability or Higher.

VideoViewability

Possible Integral Ad Science Video viewability options.

Перечисления
VIDEO_VIEWABILITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video viewability options.
VIDEO_VIEWABILITY_40 40%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_50 50%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_60 60%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_70 70%+ in view (IAB video viewability standard).

PoiAssignedTargetingOptionDetails

Details for assigned POI targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_POI .

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

string

Output only. The display name of a POI, eg "Times Square", "Space Needle", followed by its full address if available.

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_POI .

Accepted POI targeting option IDs can be retrieved using targetingTypes.targetingOptions.search .

If targeting a specific latitude/longitude coordinate removed from an address or POI name, you can generate the necessary targeting option ID by rounding the desired coordinate values to the 6th decimal place, removing the decimals, and concatenating the string values separated by a semicolon. For example, you can target the latitude/longitude pair of 40.7414691, -74.003387 using the targeting option ID "40741469;-74003387". Upon creation, this field value will be updated to append a semicolon and alphanumerical hash value if only latitude/longitude coordinates are provided.

latitude

number

Output only. Latitude of the POI rounding to 6th decimal place.

longitude

number

Output only. Longitude of the POI rounding to 6th decimal place.

proximityRadiusAmount

number

Required. The radius of the area around the POI that will be targeted. The units of the radius are specified by proximityRadiusUnit . Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES .

proximityRadiusUnit

enum ( DistanceUnit )

Required. The unit of distance by which the targeting radius is measured.

DistanceUnit

Possible distance unit options.

Перечисления
DISTANCE_UNIT_UNSPECIFIED В данной версии тип значения не указан или неизвестен.
DISTANCE_UNIT_MILES Мили.
DISTANCE_UNIT_KILOMETERS Километры.

BusinessChainAssignedTargetingOptionDetails

Details for assigned Business chain targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_BUSINESS_CHAIN .

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

string

Output only. The display name of a business chain, eg "KFC", "Chase Bank".

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BUSINESS_CHAIN .

Accepted business chain targeting option IDs can be retrieved using SearchTargetingOptions .

proximityRadiusAmount

number

Required. The radius of the area around the business chain that will be targeted. The units of the radius are specified by proximityRadiusUnit . Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES . The minimum increment for both cases is 0.1. Inputs will be rounded to the nearest acceptable value if it is too granular, eg 15.57 will become 15.6.

proximityRadiusUnit

enum ( DistanceUnit )

Required. The unit of distance by which the targeting radius is measured.

ContentDurationAssignedTargetingOptionDetails

Details for content duration assigned targeting option. This will be populated in the contentDurationDetails field when targetingType is TARGETING_TYPE_CONTENT_DURATION . Explicitly targeting all options is not supported. Remove all content duration targeting options to achieve this effect.

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

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_DURATION .

contentDuration

enum ( ContentDuration )

Output only. The content duration.

ContentStreamTypeAssignedTargetingOptionDetails

Details for content stream type assigned targeting option. This will be populated in the contentStreamTypeDetails field when targetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE . Explicitly targeting all options is not supported. Remove all content stream type targeting options to achieve this effect.

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

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE .

contentStreamType

enum ( ContentStreamType )

Output only. The content stream type.

NativeContentPositionAssignedTargetingOptionDetails

Details for native content position assigned targeting option. This will be populated in the nativeContentPositionDetails field when targetingType is TARGETING_TYPE_NATIVE_CONTENT_POSITION . Explicitly targeting all options is not supported. Remove all native content position targeting options to achieve this effect.

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

enum ( NativeContentPosition )

Required. The content position.

OmidAssignedTargetingOptionDetails

Represents a targetable Open Measurement enabled inventory type. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_OMID .

JSON representation 
{
  "omid": enum (Omid)
}
Поля
omid

enum ( Omid )

Required. The type of Open Measurement enabled inventory.

AudioContentTypeAssignedTargetingOptionDetails

Details for audio content type assigned targeting option. This will be populated in the audioContentTypeDetails field when targetingType is TARGETING_TYPE_AUDIO_CONTENT_TYPE . Explicitly targeting all options is not supported. Remove all audio content type targeting options to achieve this effect.

JSON representation 
{
  "audioContentType": enum (AudioContentType)
}
Поля
audioContentType

enum ( AudioContentType )

Required. The audio content type.

ContentGenreAssignedTargetingOptionDetails

Details for content genre assigned targeting option. This will be populated in the contentGenreDetails field when targetingType is TARGETING_TYPE_CONTENT_GENRE . Explicitly targeting all options is not supported. Remove all content genre targeting options to achieve this effect.

JSON representation 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Поля
targetingOptionId

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_GENRE .

displayName

string

Output only. The display name of the content genre.

negative

boolean

Indicates if this option is being negatively targeted.

YoutubeVideoAssignedTargetingOptionDetails

Details for YouTube video assigned targeting option. This will be populated in the youtubeVideoDetails field when targetingType is TARGETING_TYPE_YOUTUBE_VIDEO .

JSON representation 
{
  "videoId": string,
  "negative": boolean
}
Поля
videoId

string

YouTube video id as it appears on the YouTube watch page.

negative

boolean

Indicates if this option is being negatively targeted.

YoutubeChannelAssignedTargetingOptionDetails

Details for YouTube channel assigned targeting option. This will be populated in the youtubeChannelDetails field when targetingType is TARGETING_TYPE_YOUTUBE_CHANNEL .

JSON representation 
{
  "channelId": string,
  "negative": boolean
}
Поля
channelId

string

The YouTube uploader channel id or the channel code of a YouTube channel.

negative

boolean

Indicates if this option is being negatively targeted.

SessionPositionAssignedTargetingOptionDetails

Details for session position assigned targeting option. This will be populated in the sessionPositionDetails field when targetingType is TARGETING_TYPE_SESSION_POSITION .

JSON representation 
{
  "sessionPosition": enum (SessionPosition)
}
Поля
sessionPosition

enum ( SessionPosition )

The position where the ad will show in a session.

SessionPosition

Possible positions in a session.

Перечисления
SESSION_POSITION_UNSPECIFIED This is a placeholder, does not indicate any positions.
SESSION_POSITION_FIRST_IMPRESSION The first impression of the session.

Методы

create

 Assigns a targeting option to an ad group.

delete

 Deletes an assigned targeting option from an ad group.

get

 Gets a single targeting option assigned to an ad group.

list

 Lists the targeting options assigned to an ad group.