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)
  },
  "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 .

Методы

create

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

delete

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

get

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

list

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