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 )

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

Подробная информация о поле Union field details . Подробная информация о назначенном параметре таргетинга. В поле 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 .

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

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

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 )

Данные об инвентаре с включенным инвентарем Open Measurement. Это поле будет заполнено, если тип targetingType — TARGETING_TYPE_OMID .

audioContentTypeDetails

object ( AudioContentTypeAssignedTargetingOptionDetails )

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

contentGenreDetails

object ( ContentGenreAssignedTargetingOptionDetails )

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

youtubeVideoDetails

object ( YoutubeVideoAssignedTargetingOptionDetails )

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

youtubeChannelDetails

object ( YoutubeChannelAssignedTargetingOptionDetails )

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

sessionPositionDetails

object ( SessionPositionAssignedTargetingOptionDetails )

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

Методы

create

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

delete

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

get

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

list

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