REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

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

JSON-представление
{
  "name": string,
  "assignedTargetingOptionId": 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)
  }
  // End of list of possible types for union field details.
}
Поля
name

string

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

assignedTargetingOptionId

string

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

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 .

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

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

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

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 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),
  "targetingOptionId": string
}
Поля
ageRange

enum ( AgeRange )

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

Вывод только в v1. Требуется в v2.

targetingOptionId

string

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

Региональный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,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
Поля
proximityLocationListId

string ( int64 format)

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

proximityRadiusRange

enum ( ProximityRadiusRange )

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

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

БлизостьРадиусДиапазон

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

Перечисления
PROXIMITY_RADIUS_RANGE_UNSPECIFIED Целевой диапазон радиусов не указан или неизвестен. Значение по умолчанию, если в этой версии не указан диапазон радиусов. Это перечисление является заполнителем для значения по умолчанию и не представляет собой реальный параметр диапазона радиуса.
PROXIMITY_RADIUS_RANGE_SMALL Целевой диапазон радиусов невелик.
PROXIMITY_RADIUS_RANGE_MEDIUM Целевой диапазон радиусов средний.
PROXIMITY_RADIUS_RANGE_LARGE Диапазон целевого радиуса велик.

GenderAssignedTargetingOptionDetails

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

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

enum ( Gender )

Пол аудитории.

Вывод только в v1. Требуется в v2.

targetingOptionId

string

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

string

Необходимый. Поле targetingOptionId , если targetingType имеет TARGETING_TYPE_VIDEO_PLAYER_SIZE .

videoPlayerSize

enum ( VideoPlayerSize )

Размер видеоплеера.

Вывод только в v1. Требуется в v2.

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),
  "targetingOptionId": string
}
Поля
parentalStatus

enum ( ParentalStatus )

Родительский статус аудитории.

Вывод только в v1. Требуется в v2.

targetingOptionId

string

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

ContentInstreamPositionAssignedTargetingOptionDetails

Сведения о назначенном параметре таргетинга на позицию в потоке контента. Оно будет заполнено в поле contentInstreamPositionDetails , если targetingType имеет значение TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

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

string

Необходимый. Поле targetingOptionId , если targetingType имеет TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

contentInstreamPosition

enum ( ContentInstreamPosition )

Позиция контента в видео- или аудиорекламе.

Вывод только в v1. Требуется в v2.

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-представление
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Поля
targetingOptionId

string

Необходимый. Поле targetingOptionId , если targetingType имеет TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION .

contentOutstreamPosition

enum ( ContentOutstreamPosition )

Позиция контента вне потока.

Вывод только в v1. Требуется в v2.

adType

enum ( AdType )

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

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

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

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

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

string

Необходимый. Идентификатор типа устройства.

deviceType

enum ( DeviceType )

Отображаемое имя типа устройства.

Вывод только в v1. Требуется в v2.

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),
  "targetingOptionId": string
}
Поля
householdIncome

enum ( HouseholdIncome )

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

Вывод только в v1. Требуется в v2.

targetingOptionId

string

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

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

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

enum ( Environment )

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

Вывод только в v1. Требуется в v2.

targetingOptionId

string

Необходимый. targetingOptionId для TargetingOption типа TARGETING_TYPE_ENVIRONMENT (например, «508010» для таргетинга на параметр ENVIRONMENT_WEB_OPTIMIZED ).

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),
  "targetingOptionId": string
}
Поля
viewability

enum ( Viewability )

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

Вывод только в v1. Требуется в v2.

targetingOptionId

string

Необходимый. targetingOptionId для TargetingOption типа TARGETING_TYPE_VIEWABILITY (например, «509010» для таргетинга на параметр VIEWABILITY_10_PERCENT_OR_MORE ).

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-представление
{
  "excludedTargetingOptionId": string,
  "contentRatingTier": enum (ContentRatingTier)
}
Поля
excludedTargetingOptionId

string

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

contentRatingTier

enum ( ContentRatingTier )

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

string

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

sensitiveCategory

enum ( SensitiveCategory )

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

ExchangeAssignedTargetingOptionDetails

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

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

string

Необходимый. targetingOptionId TargetingOption типа TARGETING_TYPE_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 можно получить с помощью SearchTargetingOptions .

Если таргетинг на определенную координату широты и долготы удален из адреса или названия 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-представление
{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}
Поля
targetingOptionId

string

Необходимый. Поле targetingOptionId , если targetingType имеет TARGETING_TYPE_NATIVE_CONTENT_POSITION .

contentPosition

enum ( NativeContentPosition )

Позиция содержания.

Вывод только в v1. Требуется в v2.

OmidAssignedTargetingOptionDetails

Представляет целевой тип инвентаря с поддержкой Open Measurement. Оно будет заполнено в поле сведений AssignedTargetingOption, если targetingType имеет TARGETING_TYPE_OMID .

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

enum ( Omid )

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

Вывод только в v1. Требуется в v2.

targetingOptionId

string

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

string

Необходимый. Поле targetingOptionId , если targetingType имеет TARGETING_TYPE_AUDIO_CONTENT_TYPE .

audioContentType

enum ( AudioContentType )

Тип аудиоконтента.

Вывод только в v1. Требуется в v2.

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

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

Методы

get

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

list

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