REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

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

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

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "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

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

assigned Targeting Option Id

string

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

assigned Targeting Option Id Alias

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
targeting Type

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

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

details поля объединения. Подробная информация о назначаемом параметре таргетинга. Детально может быть заполнено только одно поле, и оно должно соответствовать targeting_type ; details могут быть только одним из следующих:
channel Details

object ( ChannelAssignedTargetingOptionDetails )

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

app Category Details

object ( AppCategoryAssignedTargetingOptionDetails )

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

app Details

object ( AppAssignedTargetingOptionDetails )

Подробности приложения. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_APP .

url Details

object ( UrlAssignedTargetingOptionDetails )

Подробности URL-адреса. Это поле будет заполнено, если для targetingType установлено значение TARGETING_TYPE_URL .

day And Time Details

object ( DayAndTimeAssignedTargetingOptionDetails )

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

age Range Details

object ( AgeRangeAssignedTargetingOptionDetails )

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

regional Location List Details

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximity Location List Details

object ( ProximityLocationListAssignedTargetingOptionDetails )

Детали списка ближайших местоположений. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_PROXIMITY_LOCATION_LIST .

gender Details

object ( GenderAssignedTargetingOptionDetails )

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

video Player Size Details

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

Детали размера видеоплеера. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_VIDEO_PLAYER_SIZE .

user Rewarded Content Details

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parental Status Details

object ( ParentalStatusAssignedTargetingOptionDetails )

Подробности о родительском статусе. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_PARENTAL_STATUS .

content Instream Position Details

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

Сведения о позиции In-Stream контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

content Outstream Position Details

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

Сведения о позиции исходящего контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION .

device Type Details

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audience Group Details

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browser Details

object ( BrowserAssignedTargetingOptionDetails )

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

household Income Details

object ( HouseholdIncomeAssignedTargetingOptionDetails )

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

on Screen Position Details

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrier And Isp Details

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keyword Details

object ( KeywordAssignedTargetingOptionDetails )

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

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

negative Keyword List Details

object ( NegativeKeywordListAssignedTargetingOptionDetails )

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

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

operating System Details

object ( OperatingSystemAssignedTargetingOptionDetails )

Подробности об операционной системе. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_OPERATING_SYSTEM .

device Make Model Details

object ( DeviceMakeModelAssignedTargetingOptionDetails )

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

environment Details

object ( EnvironmentAssignedTargetingOptionDetails )

Детали окружения. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_ENVIRONMENT .

inventory Source Details

object ( InventorySourceAssignedTargetingOptionDetails )

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

category Details

object ( CategoryAssignedTargetingOptionDetails )

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

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

viewability Details

object ( ViewabilityAssignedTargetingOptionDetails )

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

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

authorized Seller Status Details

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

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

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

Если у ресурса нет опции статуса авторизованного продавца, по умолчанию таргетингом становятся все авторизованные продавцы, указанные как ПРЯМЫЕ или ПОСРЕДНИКИ в файлеads.txt.

language Details

object ( LanguageAssignedTargetingOptionDetails )

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

geo Region Details

object ( GeoRegionAssignedTargetingOptionDetails )

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

inventory Source Group Details

object ( InventorySourceGroupAssignedTargetingOptionDetails )

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

digital Content Label Exclusion Details

object ( DigitalContentLabelAssignedTargetingOptionDetails )

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

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

sensitive Category Exclusion Details

object ( SensitiveCategoryAssignedTargetingOptionDetails )

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

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

exchange Details

object ( ExchangeAssignedTargetingOptionDetails )

Детали обмена. Это поле будет заполнено, если targetingType имеет TARGETING_TYPE_EXCHANGE .

sub Exchange Details

object ( SubExchangeAssignedTargetingOptionDetails )

Детали суббиржи. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_SUB_EXCHANGE .

third Party Verifier Details

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

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

poi Details

object ( PoiAssignedTargetingOptionDetails )

Детали POI. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_POI .

business Chain Details

object ( BusinessChainAssignedTargetingOptionDetails )

Детали бизнес-цепочки. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_BUSINESS_CHAIN .

content Duration Details

object ( ContentDurationAssignedTargetingOptionDetails )

Подробности о продолжительности контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_DURATION .

content Stream Type Details

object ( ContentStreamTypeAssignedTargetingOptionDetails )

Подробности о продолжительности контента. Это поле будет заполнено, если TargetingType имеет значение TARGETING_TYPE_CONTENT_STREAM_TYPE .

native Content Position Details

object ( NativeContentPositionAssignedTargetingOptionDetails )

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

omid Details

object ( OmidAssignedTargetingOptionDetails )

Сведения об инвентаризации с включенной функцией Open Measurement. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_OMID .

audio Content Type Details

object ( AudioContentTypeAssignedTargetingOptionDetails )

Подробности о типах аудиоконтента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_AUDIO_CONTENT_TYPE .

content Genre Details

object ( ContentGenreAssignedTargetingOptionDetails )

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

youtube Video Details

object ( YoutubeVideoAssignedTargetingOptionDetails )

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

youtube Channel Details

object ( YoutubeChannelAssignedTargetingOptionDetails )

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

session Position Details

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
}
Поля
channel Id

string ( int64 format)

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

negative

boolean

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

AppCategoryAssignedTargetingOptionDetails

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

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

string

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

targeting Option Id

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)
}
Поля
app Id

string

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

Приложение Play Store для Android использует идентификатор пакета, например com.google.android.gm . Идентификатор приложения Apple App Store использует 9-значную строку, например 422689480 .

display Name

string

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

negative

boolean

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

app Platform

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)
}
Поля
day Of Week

enum ( DayOfWeek )

Необходимый. День недели для этого дня и настройки таргетинга на время.

start Hour

integer

Необходимый. Час начала для таргетинга на день и время. Должно быть от 0 (начало дня) до 23 (за 1 час до конца дня).

end Hour

integer

Необходимый. Конечный час для таргетинга на день и время. Должно быть от 1 (1 час после начала дня) до 24 (конец дня).

time Zone Resolution

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)
}
Поля
age Range

enum ( AgeRange )

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

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

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

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

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)
}
Поля
proximity Location List Id

string ( int64 format)

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

proximity Radius

number

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

proximity Radius Unit

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)
}
Поля
video Player Size

enum ( VideoPlayerSize )

Необходимый. Размер видеоплеера.

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

Необходимый. Поле targetingOptionId , если targetingType имеет значение TARGETING_TYPE_USER_REWARDED_CONTENT .

user Rewarded Content

enum ( UserRewardedContent )

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

ParentalStatusAssignedTargetingOptionDetails

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

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

enum ( ParentalStatus )

Необходимый. Родительский статус аудитории.

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum ( ContentInstreamPosition )

Необходимый. Позиция контента в видео- или аудиорекламе.

ad Type

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)
}
Поля
content Outstream Position

enum ( ContentOutstreamPosition )

Необходимый. Позиция контента вне потока.

ad Type

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-представление 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
Поля
device Type

enum ( DeviceType )

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

youtube And Partners Bid Multiplier

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)
  }
}
Поля
included First And Third Party Audience Groups[]

object ( FirstAndThirdPartyAudienceGroup )

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

included Google Audience Group

object ( GoogleAudienceGroup )

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

included Custom List Group

object ( CustomListGroup )

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

included Combined Audience Group

object ( CombinedAudienceGroup )

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

excluded First And Third Party Audience Group

object ( FirstAndThirdPartyAudienceGroup )

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

excluded Google Audience Group

object ( GoogleAudienceGroup )

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

FirstAndThirdPartyAudienceGroup

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

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

object ( FirstAndThirdPartyAudienceTargetingSetting )

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

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

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

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

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
}
Поля
google Audience Id

string ( int64 format)

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

CustomListGroup

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

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

object ( CustomListTargetingSetting )

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

Настройка CustomListTargetingSetting

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

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

string ( int64 format)

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

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

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

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

object ( CombinedAudienceTargetingSetting )

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

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

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

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

string ( int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

targeting Option Id

string

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

negative

boolean

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

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

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

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

enum ( HouseholdIncome )

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

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

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

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

string

Необходимый. Поле targetingOptionId , если targetingType имеет значение TARGETING_TYPE_ON_SCREEN_POSITION .

on Screen Position

enum ( OnScreenPosition )

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

ad Type

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
}
Поля
display Name

string

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

targeting Option Id

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
}
Поля
negative Keyword List Id

string ( int64 format)

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

OperationSystemAssignedTargetingOptionDetails

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

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

string

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

targeting Option Id

string

Необходимый. Идентификатор варианта таргетинга заполняется в поле targetingOptionId если targetingType имеет значение TARGETING_TYPE_OPERATING_SYSTEM .

negative

boolean

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

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

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

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

string

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

targeting Option Id

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
}
Поля
inventory Source Id

string ( int64 format)

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

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

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

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

string

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

targeting Option Id

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
}
Поля
authorized Seller Status

enum ( AuthorizedSellerStatus )

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

targeting Option Id

string

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

LanguageAssignedTargetingOptionDetails

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

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

string

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

targeting Option Id

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
}
Поля
display Name

string

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

targeting Option Id

string

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

geo Region Type

enum ( GeoRegionType )

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

negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum ( ContentRatingTier )

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

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
}
Поля
targeting Option Id

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.

double Verify

object ( DoubleVerify )

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

integral Ad Science

object ( IntegralAdScience )

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

Адлукс

Подробная информация о настройках безопасности бренда Adloox.

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

enum ( AdlooxCategory )

Категории Adloox, которые следует исключить.

excluded Fraud Ivt Mfa Categories[]

enum ( FraudIvtMfaCategory )

Необязательный. Мошеннические категории Adloox IVT MFA, которые необходимо исключить.

adult Explicit Sexual Content

enum ( GarmRiskExclusion )

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

crime Harmful Acts Individuals Society Human Rights Violations Content

enum ( GarmRiskExclusion )

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

arms Ammunition Content

enum ( GarmRiskExclusion )

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

death Injury Military Conflict Content

enum ( GarmRiskExclusion )

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

debated Sensitive Social Issue Content

enum ( GarmRiskExclusion )

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

illegal Drugs Tobacco Ecigarettes Vaping Alcohol Content

enum ( GarmRiskExclusion )

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

online Piracy Content

enum ( GarmRiskExclusion )

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

hate Speech Acts Aggression Content

enum ( GarmRiskExclusion )

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

obscenity Profanity Content

enum ( GarmRiskExclusion )

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

spam Harmful Content

enum ( GarmRiskExclusion )

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

terrorism Content

enum ( GarmRiskExclusion )

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

misinformation Content

enum ( GarmRiskExclusion )

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

display Iab Viewability

enum ( DisplayIabViewability )

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

video Iab Viewability

enum ( VideoIabViewability )

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

Категория Adloox

Доступные категории Adloox.

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

МошенничествоIvtMfaКатегория

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

Перечисления
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Значение по умолчанию, если категория Adloox Fraud, IVT, MFA не указана или неизвестна в этой версии.
FRAUD_IVT_MFA МОШЕННИЧЕСТВО, ИВТ, МИД.

ГармРискИсключение

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

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

DisplayIabВидимость

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

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

VideoIabВидимость

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

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

DoubleVerify

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

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

object ( BrandSafetyCategories )

Контроль безопасности бренда DV.

avoided Age Ratings[]

enum ( AgeRating )

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

app Star Rating

object ( AppStarRating )

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

display Viewability

object ( DisplayViewability )

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

video Viewability

object ( VideoViewability )

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

fraud Invalid Traffic

object ( FraudInvalidTraffic )

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

custom Segment Id

string ( int64 format)

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

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

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

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

boolean

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

avoided High Severity Categories[]

enum ( HighSeverityCategory )

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

avoided Medium Severity Categories[]

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
}
Поля
avoided Star Rating

enum ( StarRating )

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

avoid Insufficient Star Rating

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.

viewable During

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% или выше.

Viewableding

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

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

VideoViewability

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

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

enum ( VideoIAB )

Целевой веб -запасы, чтобы максимизировать просмотр IAB.

video Viewable Rate

enum ( VideoViewableRate )

Целевой веб -запасы, чтобы максимизировать полностью просмотр.

player Impression Rate

enum ( PlayerImpressionRate )

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

Видеоаб

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

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

VideoViewableRate

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

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

PlayerImpressionRate

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

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

Fradinvalidtraffic

DoubleVerify мошенничество и недопустимые настройки трафика.

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

enum ( FraudOption )

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

avoid Insufficient Option

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.

IntegralAdScience

Детали интегральных настройки науки о рекламе.

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
  ]
}
Поля
traq Score Option

enum ( TRAQScore )

Истинное качество рекламы (применимо только к отображению позиций).

exclude Unrateable

boolean

Безопасность бренда - неприличная .

excluded Adult Risk

enum ( Adult )

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

excluded Alcohol Risk

enum ( Alcohol )

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

excluded Illegal Downloads Risk

enum ( IllegalDownloads )

Безопасность бренда - незаконные загрузки .

excluded Drugs Risk

enum ( Drugs )

Безопасность бренда - лекарства .

excluded Hate Speech Risk

enum ( HateSpeech )

Безопасность бренда - ненавистная речь .

excluded Offensive Language Risk

enum ( OffensiveLanguage )

Безопасность бренда - атакующий язык .

excluded Violence Risk

enum ( Violence )

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

excluded Gambling Risk

enum ( Gambling )

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

excluded Ad Fraud Risk

enum ( AdFraudPrevention )

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

display Viewability

enum ( DisplayViewability )

Раздел о просмотре отображения (применимо только к отображению элементов линии).

video Viewability

enum ( VideoViewability )

Раздел просматриваемости видео (применимо только к видео -линии).

custom Segment Id[]

string ( int64 format)

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

TRAQSCORE

Возможные интегральные ad Science Traq (истинное качество рекламы).

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

Взрослый

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

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

Алкоголь

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

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

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

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

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

Наркотики

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

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

Хейтспич

Возможные интегральные варианты речи Hate Science.

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

OffensiveLanguage

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

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

Насилие

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

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

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

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

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

Adfraudprevention

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

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

DisplayVikability

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

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

VideoViewability

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

Перечисление
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. Это будет заполнено в поле «Подробности назначенного», когда TARGETING_TYPE_POI targetingType

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

string

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

targeting Option Id

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 -го десятичного места.

proximity Radius Amount

number

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

proximity Radius Unit

enum ( DistanceUnit )

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

Дистанция

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

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

BusinessChainassignedTargetingOptionDetails

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

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

string

Только вывод. Отображение названия бизнес -сети, например, «KFC», «Чейз Банк».

targeting Option Id

string

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

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

proximity Radius Amount

number

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

proximity Radius Unit

enum ( DistanceUnit )

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

ContentDurationAssignedTargetingOptionDetails

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

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

string

Необходимый. Поле targetingOptionId при targetingType является TARGETING_TYPE_CONTENT_DURATION .

content Duration

enum ( ContentDuration )

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

Содержание

Подробная информация о типе потока контента присваивается опция таргетирования. Это будет заполнено в поле contentStreamTypeDetails , когда targetingType TARGETING_TYPE_CONTENT_STREAM_TYPE . Явно нацеливание на все варианты не поддерживается. Удалите все параметры таргетинга типа потока контента для достижения этого эффекта.

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

string

Необходимый. Поле targetingOptionId при targetingType является TARGETING_TYPE_CONTENT_STREAM_TYPE .

content Stream Type

enum ( ContentStreamType )

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

NativeContentPositionAssignedTargetingOptionDetails

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

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

enum ( NativeContentPosition )

Необходимый. Положение содержания.

OmidassignedTargetingOptionDetails

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

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

enum ( Omid )

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

AudioContentTyPeasSignedTargetingOptionDetails

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

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

enum ( AudioContentType )

Необходимый. Аудио -контент тип.

ContentGenReaseNedTargetingOptionDetails

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

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

string

Необходимый. Поле targetingOptionId при targetingType является TARGETING_TYPE_CONTENT_GENRE .

display Name

string

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

negative

boolean

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

YouTubeVideoAssignedTargetingOptionDetails

Подробная информация для видео на YouTube назначено опцией таргетирования. Это будет заполнено в поле youtubeVideoDetails , когда targetingType IS TARGETING_TYPE_YOUTUBE_VIDEO .

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

string

YouTube Video Id, как он отображается на странице Watch Watch YouTube.

negative

boolean

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

YouTubeChannelAssIgnedTargetingOptionDetails

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

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

string

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

negative

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum ( SessionPosition )

Позиция, где объявление будет отображаться в сессии.

SessionPosition

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

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

Методы

get

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

list

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