REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

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

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

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Поля
name

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

Только для вывода. Псевдоним для assignedTargetingOptionId . Это значение можно использовать вместо assignedTargetingOptionId при получении или удалении существующих параметров таргетинга.

Это поле будет поддерживаться только для всех назначенных параметров таргетинга следующих типов:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Это поле также поддерживается для параметров таргетинга, назначаемых отдельным позициям, следующих типов таргетинга:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

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

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

object ( ChannelAssignedTargetingOptionDetails )

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

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

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

appDetails

object ( AppAssignedTargetingOptionDetails )

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

urlDetails

object ( UrlAssignedTargetingOptionDetails )

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

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

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

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

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

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

Подробная информация о списке ближайших местоположений. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_PROXIMITY_LOCATION_LIST .

genderDetails

object ( GenderAssignedTargetingOptionDetails )

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

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

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

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

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

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

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

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

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

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

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

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

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

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

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

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

negativeKeywordListDetails

object ( NegativeKeywordListAssignedTargetingOptionDetails )

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

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

operatingSystemDetails

object ( OperatingSystemAssignedTargetingOptionDetails )

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

deviceMakeModelDetails

object ( DeviceMakeModelAssignedTargetingOptionDetails )

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

environmentDetails

object ( EnvironmentAssignedTargetingOptionDetails )

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

inventorySourceDetails

object ( InventorySourceAssignedTargetingOptionDetails )

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

categoryDetails

object ( CategoryAssignedTargetingOptionDetails )

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

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

viewabilityDetails

object ( ViewabilityAssignedTargetingOptionDetails )

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

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

authorizedSellerStatusDetails

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

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

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

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

languageDetails

object ( LanguageAssignedTargetingOptionDetails )

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

geoRegionDetails

object ( GeoRegionAssignedTargetingOptionDetails )

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

inventorySourceGroupDetails

object ( InventorySourceGroupAssignedTargetingOptionDetails )

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

digitalContentLabelExclusionDetails

object ( DigitalContentLabelAssignedTargetingOptionDetails )

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

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

sensitiveCategoryExclusionDetails

object ( SensitiveCategoryAssignedTargetingOptionDetails )

Конфиденциальные сведения о категории. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

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

contentThemeExclusionDetails

object ( ContentThemeAssignedTargetingOptionDetails )

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

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

exchangeDetails

object ( ExchangeAssignedTargetingOptionDetails )

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

subExchangeDetails

object ( SubExchangeAssignedTargetingOptionDetails )

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

thirdPartyVerifierDetails

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

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

poiDetails

object ( PoiAssignedTargetingOptionDetails )

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

businessChainDetails

object ( BusinessChainAssignedTargetingOptionDetails )

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

contentDurationDetails

object ( ContentDurationAssignedTargetingOptionDetails )

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

contentStreamTypeDetails

object ( ContentStreamTypeAssignedTargetingOptionDetails )

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

nativeContentPositionDetails

object ( NativeContentPositionAssignedTargetingOptionDetails )

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

omidDetails

object ( OmidAssignedTargetingOptionDetails )

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

audioContentTypeDetails

object ( AudioContentTypeAssignedTargetingOptionDetails )

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

contentGenreDetails

object ( ContentGenreAssignedTargetingOptionDetails )

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

youtubeVideoDetails

object ( YoutubeVideoAssignedTargetingOptionDetails )

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

youtubeChannelDetails

object ( YoutubeChannelAssignedTargetingOptionDetails )

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

sessionPositionDetails

object ( SessionPositionAssignedTargetingOptionDetails )

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

Методы

create

 Присваивает параметр таргетинга заказу на вставку.

delete

 Удаляет назначенный параметр таргетинга из заказа на вставку.

get

 Присваивает заказу на вставку один вариант таргетинга.

list

 Отображает список параметров таргетинга, назначенных заказу на вставку.