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 )

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

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 .

Методы

get

 Присваивает кампании один вариант таргетинга.

list

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