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

Целевые данные для источника инвентаря. Это будет заполнено в поле «Подробности назначенного», когда targetingType является TARGETING_TYPE_INVENTORY_SOURCE .

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

string ( int64 format)

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

Категория AssignedTargetingOptionDetails

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

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

Посещение AssignedTargetingOptionDetails

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

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

enum ( Viewability )

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

Авторизованный sellerStatusAssignedTargetingOptionDetails

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

LanguageAsignedTargetingOptionDetails

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

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

Представление 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

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

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

string ( int64 format)

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

DigitalContentlabelassignedTargetingOptionDetails

Целевые детали на этикетку цифрового контента. Это будет заполнено в поле «Подробности назначенного», когда TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION targetingType

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

enum ( ContentRatingTier )

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

SensiTiveCategoryAssIgnedTargetingOptionDetails

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

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

enum ( SensitiveCategory )

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

ExchangeSignedTargetingOptionDetails

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

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

enum ( Exchange )

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

SubexchangeaseSignedTargetingOptionDetails

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

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

string

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

Третья сторона версиингейна

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

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

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Поля
Союз Филд verifier . Может нацелиться на один из сторонних верификаторов, чтобы обеспечить соблюдение порогов безопасности бренда для впечатлений. verifier может быть только одним из следующих:
adloox

object ( Adloox )

Сторонний бренд Verifier - Adloox.

double Verify

object ( DoubleVerify )

Сторонний бренд Verifier - DoubleVerify.

integral Ad Science

object ( IntegralAdScience )

Третья сторона Verifier - Integral Ad Science.

Adloox

Подробная информация о настройках безопасности бренда 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 )

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

death Injury Military Conflict Content

enum ( GarmRiskExclusion )

Необязательный. Смерть, травма или военное конфликт содержание риска Гарма , чтобы исключить.

debated Sensitive Social Issue Content

enum ( GarmRiskExclusion )

Необязательный. Обсуждается, что контент -контент Garm Drange, чтобы исключить.

illegal Drugs Tobacco Ecigarettes Vaping Alcohol Content

enum ( GarmRiskExclusion )

Необязательный. Нелегальные наркотики/содержание алкоголя Гарм диапазоны, чтобы исключить.

online Piracy Content

enum ( GarmRiskExclusion )

Необязательный. Онлайн -контент пиратства Garm Riching, чтобы исключить.

hate Speech Acts Aggression Content

enum ( GarmRiskExclusion )

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

obscenity Profanity Content

enum ( GarmRiskExclusion )

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

spam Harmful Content

enum ( GarmRiskExclusion )

Необязательный. Спам или вредный контент Garm Rise Drangs, чтобы исключить.

terrorism Content

enum ( GarmRiskExclusion )

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

misinformation Content

enum ( GarmRiskExclusion )

Необязательный. Дезинформация контента Garm Rise Drangs, чтобы исключить.

display Iab Viewability

enum ( DisplayIabViewability )

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

video Iab Viewability

enum ( VideoIabViewability )

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

Adlooxcategory

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

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

Мошенничество

Доступно мошенничество Adloox, IVT, категории MFA.

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

Garmriskexclusion

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

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

DISPLAYIABVIVABILE

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

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

Видеоабвиказуемость

Доступные пороги просмотра видео 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» и состоять из восьми цифр. Пользовательский идентификатор сегмента не может быть указан вместе с любыми из следующих полей:

BrandSafetyCategories

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

Представление 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 )

Категории предотвращения тяжести средней тяжести бренда.

HighseverityCategory

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

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

MediumSeverityCategory

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

Перечисление
MEDIUM_SEVERITY_UNSPECIFIED Этот перевод является всего лишь заполнителем, и он не указывает каких -либо категорий средней тяжести.
AD_SERVERS Рекламные серверы.
ADULT_CONTENT_SWIMSUIT Содержание для взрослых: купальник.
ALTERNATIVE_LIFESTYLES Спорные предметы: альтернативный образ жизни.
CELEBRITY_GOSSIP Спорные предметы: сплетни знаменитостей.
GAMBLING Спорные предметы: азартные игры.
OCCULT Спорные предметы: оккультный.
SEX_EDUCATION Спорные предметы: половое воспитание.
DISASTER_AVIATION Бедствие: авиация.
DISASTER_MAN_MADE Бедствие: искусственное.
DISASTER_NATURAL Бедствие: естественно.
DISASTER_TERRORIST_EVENTS Бедствие: террористические мероприятия.
DISASTER_VEHICLE Бедствие: автомобиль.
ALCOHOL Наркотики/алкоголь/контролируемые вещества: алкоголь.
SMOKING Наркотики/алкоголь/контролируемые вещества: курение.
NEGATIVE_NEWS_FINANCIAL Негативные новости: финансовые.
NON_ENGLISH Содержание не-STD: неанглийский.
PARKING_PAGE Содержание не-STD: страница парковки.
UNMODERATED_UGC Немодерация 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+).

Приложение

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

Представление 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 звезды.

DisplayVikability

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

Представление 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
  ],
  "qualitySyncCustomSegmentId": [
    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 или 3000001 и 3999999 , включительно.

quality Sync Custom Segment Id[]

string ( int64 format)

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

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

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

Представление 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

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