REST Resource: advertisers.campaigns.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)
  },
  "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 )

Сведения о позиции In-Stream контента. Это поле будет заполнено, если для 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 .

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

Если у ресурса нет опции статуса авторизованного продавца, по умолчанию таргетингом становятся все авторизованные продавцы, указанные как ПРЯМЫЕ или ПОСРЕДНИКИ в файле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 .

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

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 )

Сведения об инвентаризации с включенной функцией 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 .

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

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

Перечисления
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)

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

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

Необходимый. Идентификатор приложения.

Приложение Play Store для Android использует идентификатор пакета, например com.google.android.gm . Идентификатор приложения Apple App Store использует 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.

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 )

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

День недели

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

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

РегиональныйLocationListAssignedTargetingOptionDetails

Детали таргетинга для списка региональных местоположений. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_REGIONAL_LOCATION_LIST .

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

string ( int64 format)

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

negative

boolean

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

БлизостьLocationListAssignedTargetingOptionDetails

Детали таргетинга для списка ближайших местоположений. Оно будет заполнено в поле сведений 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

Сведения о параметрах таргетинга на позицию назначенного контента в In-Stream. Оно будет заполнено в поле 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 .

Тип объявления

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

Перечисления
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

Подробности таргетинга для типа устройства. Оно будет заполнено в поле сведений 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 . Связь между каждой группой — СОЕДИНЕНИЕ, за исключением исключеннойFirstAndThirdPartyAudienceGroup и исключеннойGoogleAudienceGroup, в которых ДОПОЛНЕНИЕ используется как ПЕРЕСЕКАЕНИЕ с другими группами.

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

object ( FirstAndThirdPartyAudienceGroup )

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

includedGoogleAudienceGroup

object ( GoogleAudienceGroup )

Идентификаторы аудитории Google включенной группы аудитории Google. Содержит только идентификаторы аудитории Google.

includedCustomListGroup

object ( CustomListGroup )

Идентификаторы настраиваемых списков включенной группы настраиваемых списков. Содержит только идентификаторы пользовательских списков.

includedCombinedAudienceGroup

object ( CombinedAudienceGroup )

Объединенные идентификаторы аудитории включенной объединенной группы аудитории. Содержит только комбинированные идентификаторы аудитории.

excludedFirstAndThirdPartyAudienceGroup

object ( FirstAndThirdPartyAudienceGroup )

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

excludedGoogleAudienceGroup

object ( GoogleAudienceGroup )

Идентификаторы аудитории Google исключенной группы аудитории Google. Используется для негативного таргетинга. ДОПОЛНЕНИЕ СОЕДИНЕНИЯ этой группы и других исключенных групп аудитории используется как ПЕРЕСЕЧЕНО для любого положительного таргетинга на аудиторию. Содержит только аудитории Google по интересам, заинтересованным покупателям и установленным приложениям. Все элементы являются логическим оператором «ИЛИ» друг друга.

FirstAndThirdPartyAudienceGroup

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

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

object ( FirstAndThirdPartyAudienceTargetingSetting )

Необходимый. Все настройки таргетинга на собственную и стороннюю аудиторию в первой и сторонней группах аудитории. Повторные настройки с одним и тем же идентификатором не допускаются.

Настройка таргетинга FirstAndThirdPartyAudience

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

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

string ( int64 format)

Необходимый. Идентификаторы собственной и сторонней аудитории для настройки таргетинга на собственную и стороннюю аудиторию. Этот идентификатор — firstAndThirdPartyAudienceId .

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 дней.

Группа GoogleAudienceGroup

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

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

object ( GoogleAudienceTargetingSetting )

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

Настройка таргетинга GoogleAudience

Подробности настройки таргетинга аудитории 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 )

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

Комбинированная настройка таргетинга на аудиторию

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

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

string ( int64 format)

Необходимый. Идентификатор объединенной аудитории для настройки таргетинга на объединенную аудиторию. Этот идентификатор combinedAudienceId .

BrowserAssignedTargetingOptionDetails

Подробности о назначенном параметре таргетинга браузера. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_BROWSER .

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

string

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

targetingOptionId

string

Необходимый. targetingOptionId TargetingOption типа TARGETING_TYPE_BROWSER .

negative

boolean

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

ДомохозяйствоДоходНазначеноТаргетингОпцияПодробнее

Подробная информация о назначенном параметре таргетинга на семейный доход. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_HOUSEHOLD_INCOME .

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

enum ( HouseholdIncome )

Необходимый. Семейный доход аудитории.

Онскринпозиционассинтедтаргетингоптииондетали

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

string

Необходимый. Ключевое слово, например car insurance .

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

negative

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

Подробности таргетинга для списка минус-слов. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_NEGATIVE_KEYWORD_LIST .

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

string ( int64 format)

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

OperationSystemAssignedTargetingOptionDetails

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

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

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

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

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

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

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

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

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

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

string

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

targetingOptionId

string

Необходимый. targetingOptionId TargetingOption типа TARGETING_TYPE_LANGUAGE .

negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

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

string ( int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum ( ContentRatingTier )

Необходимый. Отображаемое название уровня рейтинга метки цифрового контента, подлежащего ИСКЛЮЧЕНИЮ.

SensitiveCategoryAssignedTargetingOptionDetails

Детали таргетинга для деликатной категории. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

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

enum ( SensitiveCategory )

Необходимый. Перечисление для содержания деликатной категории DV360, отнесенного к ИСКЛЮЧЕННОМУ.

ExchangeAssignedTargetingOptionDetails

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

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

enum ( Exchange )

Необходимый. Значение перечисления для обмена.

SubExchangeAssignedTargetingOptionDetails

Подробная информация о назначенном параметре таргетинга на суббиржи. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_SUB_EXCHANGE .

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

string

Необходимый. targetingOptionId TargetingOption типа TARGETING_TYPE_SUB_EXCHANGE .

ThirdPartyVerifierAssignedTargetingOptionDetails

Сведения о параметрах таргетинга назначенного стороннего верификатора. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение 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.
}
Поля
verifier поля объединения. Можно настроить таргетинг на одного из сторонних проверяющих, чтобы обеспечить соблюдение пороговых значений безопасности бренда для показов. verifier может быть только одним из следующих:
adloox

object ( Adloox )

Сторонний верификатор бренда — Adloox.

doubleVerify

object ( DoubleVerify )

Сторонний верификатор бренда — DoubleVerify.

integralAdScience

object ( IntegralAdScience )

Сторонний верификатор бренда — Integral Ad Science.

Адлукс

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

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

enum ( AdlooxCategory )

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

Категория Adloox

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

Перечисления
ADLOOX_UNSPECIFIED Это перечисление является всего лишь заполнителем и не указывает ни одного параметра Adloox.
ADULT_CONTENT_HARD Взрослый контент (жесткий).
ADULT_CONTENT_SOFT Контент для взрослых (мягкий).
ILLEGAL_CONTENT Незаконный контент.
BORDERLINE_CONTENT Пограничный контент.
DISCRIMINATORY_CONTENT Дискриминационный контент.
VIOLENT_CONTENT_WEAPONS Жестокий контент и оружие.
LOW_VIEWABILITY_DOMAINS Домены с низкой видимостью.
FRAUD Мошенничество.

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 )

Избегайте сайтов и приложений с историческими показателями мошенничества и IVT.

customSegmentId

string ( int64 format)

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

БрендКатегорииБезопасности

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

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

boolean

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

avoidedHighSeverityCategories[]

enum ( HighSeverityCategory )

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

avoidedMediumSeverityCategories[]

enum ( MediumSeverityCategory )

Категории уклонения от безопасности бренда средней степени тяжести.

Категория высокой серьезности

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

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

Категория средней серьезности

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

Перечисления
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 Негативные новости: Фармацевтика.

ВозрастРейтинг

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

Перечисления
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

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

Звездный рейтинг

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

Перечисления
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 Официальные приложения с рейтингом <4,5 звезд.

ДисплейВидимость

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

Доступно для просмотра во время

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

Перечисления
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 секунд и более.

Видимость видео

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

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

enum ( VideoIAB )

Таргетируйте веб-инвентарь, чтобы максимизировать коэффициент просмотра IAB.

videoViewableRate

enum ( VideoViewableRate )

Таргетинг веб-ресурсов на максимальную видимость.

playerImpressionRate

enum ( PlayerImpressionRate )

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

ВидеоIAB

Возможные варианты рейтинга видимости 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 % или выше.

ВидеоViewableRate

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

Перечисления
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%+ показов.

МошенничествоНедействительныйТрафик

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

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

enum ( FraudOption )

Избегайте сайтов и приложений с историческими фактами мошенничества и IVT.

avoidInsufficientOption

boolean

Недостаточная историческая статистика мошенничества и IVT.

Вариант мошенничества

Возможные варианты исторических показателей мошенничества и IVT.

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

ИнтегралАдСайенс

Подробная информация о настройках 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
  ]
}
Поля
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 ( int64 format)

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

TRAQScore

Возможные диапазоны оценок Integral Ad Science TRAQ (истинное качество рекламы).

Перечисления
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.

Взрослый

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

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

Алкоголь

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

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

Незаконные загрузки

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

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

Наркотики

Возможные варианты интегральных рекламных научных препаратов.

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

НенавистьРечь

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

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

Оскорбительные выражения

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

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

Насилие

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

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

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

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

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

Предотвращение мошенничества с рекламой

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

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

ДисплейВидимость

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

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

Видимость видео

Возможные параметры видимости видео 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).

PoiAssignedTargetingOptionDetails

Подробная информация о назначенном параметре таргетинга на POI. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет значение TARGETING_TYPE_POI .

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

string

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

targetingOptionId

string

Необходимый. targetingOptionId TargetingOption типа TARGETING_TYPE_POI .

Идентификаторы принятых вариантов таргетинга на POI можно получить с помощью targetingTypes.targetingOptions.search .

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

latitude

number

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

longitude

number

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

proximityRadiusAmount

number

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

proximityRadiusUnit

enum ( DistanceUnit )

Необходимый. Единица расстояния, в которой измеряется радиус прицеливания.

Единица расстояния

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

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

BusinessChainAssignedTargetingOptionDetails

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

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

enum ( Omid )

Необходимый. Тип инвентаря, в котором включено открытое измерение.

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, который отображается на странице просмотра YouTube.

negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

Идентификатор канала загрузки YouTube или код канала YouTube.

negative

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum ( SessionPosition )

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

СеансПозиция

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

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

Методы

get

 Получает один вариант таргетинга, назначенный кампании.

list

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