REST Resource: advertisers.campaigns.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 .

Методы

get

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

list

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