CampaignCriterion

Критерий кампании.

JSON-представление
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "campaign": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "adSchedule": {
    object (AdScheduleInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "proximity": {
    object (ProximityInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "listingScope": {
    object (ListingScopeInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "ipBlock": {
    object (IpBlockInfo)
  },
  "contentLabel": {
    object (ContentLabelInfo)
  },
  "carrier": {
    object (CarrierInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "operatingSystemVersion": {
    object (OperatingSystemVersionInfo)
  },
  "mobileDevice": {
    object (MobileDeviceInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "keywordTheme": {
    object (KeywordThemeInfo)
  },
  "localServiceId": {
    object (LocalServiceIdInfo)
  }
  // End of list of possible types for union field criterion.
}
Поля
resourceName

string

Неизменный. Имя ресурса критерия кампании. Имена ресурсов критерия кампании имеют вид:

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}

displayName

string

Только вывод. Отображаемое имя критерия.

Это поле игнорируется для мутаций.

type

enum ( CriterionType )

Только вывод. Тип критерия.

status

enum ( CampaignCriterionStatus )

Статус критерия.

campaign

string

Неизменный. Кампания, к которой относится критерий.

criterionId

string ( int64 format)

Только вывод. Идентификатор критерия.

Это поле игнорируется во время изменения.

bidModifier

number

Модификатор ставок при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы. Используйте 0, чтобы отказаться от типа устройства.

negative

boolean

Неизменный. Нацеливать ( false ) или исключать ( true ) критерий.

criterion поля объединения. Критерий кампании.

Должен быть установлен именно один. criterion может быть только одним из следующих:

keyword

object ( KeywordInfo )

Неизменный. Ключевое слово.

placement

object ( PlacementInfo )

Неизменный. Размещение.

mobileAppCategory

object ( MobileAppCategoryInfo )

Неизменный. Категория мобильного приложения.

mobileApplication

object ( MobileApplicationInfo )

Неизменный. Мобильное приложение.

location

object ( LocationInfo )

Неизменный. Расположение.

device

object ( DeviceInfo )

Неизменный. Устройство.

adSchedule

object ( AdScheduleInfo )

Неизменный. Расписание рекламы.

ageRange

object ( AgeRangeInfo )

Неизменный. Возрастной диапазон.

gender

object ( GenderInfo )

Неизменный. Пол.

incomeRange

object ( IncomeRangeInfo )

Неизменный. Диапазон доходов.

parentalStatus

object ( ParentalStatusInfo )

Неизменный. Родительский статус.

userList

object ( UserListInfo )

Неизменный. Список пользователей.

youtubeVideo

object ( YouTubeVideoInfo )

Неизменный. YouTube видео.

youtubeChannel

object ( YouTubeChannelInfo )

Неизменный. YouTube канал.

proximity

object ( ProximityInfo )

Неизменный. Близость.

topic

object ( TopicInfo )

Неизменный. Тема.

listingScope

object ( ListingScopeInfo )

Неизменный. Объем листинга.

language

object ( LanguageInfo )

Неизменный. Язык.

ipBlock

object ( IpBlockInfo )

Неизменный. IPБлок.

contentLabel

object ( ContentLabelInfo )

Неизменный. Контентлейбл.

carrier

object ( CarrierInfo )

Неизменный. Перевозчик.

userInterest

object ( UserInterestInfo )

Неизменный. Интерес пользователя.

webpage

object ( WebpageInfo )

Неизменный. Веб-страница.

operatingSystemVersion

object ( OperatingSystemVersionInfo )

Неизменный. Версия операционной системы.

mobileDevice

object ( MobileDeviceInfo )

Неизменный. Мобильное устройство.

locationGroup

object ( LocationGroupInfo )

Неизменный. Группа местоположений

customAffinity

object ( CustomAffinityInfo )

Неизменный. Пользовательская близость.

customAudience

object ( CustomAudienceInfo )

Неизменный. Индивидуальная аудитория

combinedAudience

object ( CombinedAudienceInfo )

Неизменный. Комбинированная аудитория.

keywordTheme

object ( KeywordThemeInfo )

Неизменный. Тема ключевых слов для умной кампании.

localServiceId

object ( LocalServiceIdInfo )

Неизменный. Критерий сервисной кампании GLS.

Статус критерия кампании

Возможные статусы CampaignCriterion.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение только для ответа.

ENABLED Критерий кампании включен.
PAUSED Критерий кампании приостановлен.
REMOVED Критерий кампании удален.

ЛистингСкопеИнформация

Критерий объема листинга.

JSON-представление
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Поля
dimensions[]

object ( ListingDimensionInfo )

Область действия критерия кампании.

IPBlockInfo

Критерий IpBlock, используемый для исключения IP-адресов. Мы разрешаем: - адреса IPv4 и IPv6 - индивидуальные адреса (192.168.0.1) - маски для отдельных адресов (192.168.0.1/32) - маски для сетей класса C (192.168.0.1/24)

JSON-представление
{
  "ipAddress": string
}
Поля
ipAddress

string

IP-адрес этого IP-блока.

Информация о перевозчике

Представляет критерий несущей.

JSON-представление
{
  "carrierConstant": string
}
Поля
carrierConstant

string

Имя постоянного ресурса Carrier.

Информация о версии операционной системы

Представляет целевую версию операционной системы.

JSON-представление
{
  "operatingSystemVersionConstant": string
}
Поля
operatingSystemVersionConstant

string

Имя постоянного ресурса версии операционной системы.

MobileDeviceInfo

Критерий мобильного устройства.

JSON-представление
{
  "mobileDeviceConstant": string
}
Поля
mobileDeviceConstant

string

Имя постоянного ресурса мобильного устройства.

МестоположениеГруппаИнформация

Радиус вокруг списка местоположений, указанного в фиде или наборе активов.

JSON-представление
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
Поля
geoTargetConstants[]

string

Целевые географические константы, ограничивающие объем географической области в фиде. В настоящее время разрешена только одна константа географической цели. Невозможно установить с помощью полей AssetSet.

radiusUnits

enum ( LocationGroupRadiusUnits )

Единица радиуса. Для постоянных географических целей поддерживаются мили и метры. Милли-миль и метры поддерживаются для наборов элементов фида и наборов активов. Это является обязательным и должно быть установлено в операциях CREATE.

feedItemSets[]

string

FeedItemSets, FeedItems которых являются целевыми. Если указано несколько идентификаторов, то целевыми будут все элементы, которые встречаются хотя бы в одном наборе. Это поле нельзя использовать с geoTargetConstants. Это необязательно и может быть установлено только в операциях CREATE. Невозможно установить с помощью полей AssetSet.

locationGroupAssetSets[]

string

AssetSets, чьи активы являются целевыми. Если указано несколько идентификаторов, то целевыми будут все элементы, которые встречаются хотя бы в одном наборе. Это поле нельзя использовать с фидом, константами геотаргетинга или наборами элементов фида. При использовании наборов активов следует указать либо это поле, либо EnableCustomerLevelLocationAssetSet. Оба не могут использоваться одновременно. Это можно установить только в операциях CREATE.

feed

string

Фид с указанием местоположений для таргетинга. Невозможно установить с помощью полей AssetSet. Это является обязательным и должно быть установлено в операциях CREATE.

radius

string ( int64 format)

Расстояние в единицах, определяющее радиус вокруг целевых местоположений. Это является обязательным и должно быть установлено в операциях CREATE.

enableCustomerLevelLocationAssetSet

boolean

Означает, что для таргетинга используется последний набор активов на уровне клиента. Используется с радиусом и radiusUnits. Невозможно использовать с фидом, константами геотаргетинга или наборами элементов фида. При использовании наборов активов следует указать либо это поле, либо locationGroupAssetSets. Оба не могут использоваться одновременно. Это можно установить только в операциях CREATE.

МестоположениеГруппаРадиусЕдиницы измерения

Единица радиуса расстояния в группе местоположений (например, МИЛЬ).

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
METERS Метры
MILES Майлз
MILLI_MILES Милли Майлз

Локалсервицеидинфо

Идентификатор сервиса Рекламы местных услуг. Представляет тип службы (например, install_faucet), на который может быть нацелена кампания по местным услугам.

JSON-представление
{
  "serviceId": string
}
Поля
serviceId

string

Имя ресурса критерия.