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)

仅限输出。条件的 ID。

在变更期间，此字段会被忽略。
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)

不可变。IPBlock。
contentLabel

object (ContentLabelInfo)

不可变。ContentLabel。
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 服务广告系列条件。

CampaignCriterionStatus

Campaigncriteria 的可能状态。

枚举
UNSPECIFIED 未指定任何值。
UNKNOWN

此版本中未知的值。

这是一个仅用于响应的值。
ENABLED 启用广告系列条件。
PAUSED 广告系列定位条件已暂停。
REMOVED 广告系列条件将被移除。

ListingScopeInfo

商家信息范围条件。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
字段
dimensions[]

object (ListingDimensionInfo)

广告系列定位条件的范围。

IpBlockInfo

用于 IP 排除的 IpBlock 条件。我们允许：- IPv4 和 IPv6 地址 - 个人地址 (192.168.0.1) - 单个地址的掩码 (192.168.0.1/32) - C 类网络的掩码 (192.168.0.1/24)

JSON 表示法 
{
  "ipAddress": string
}
字段
ipAddress

string

此 IP 地址块的 IP 地址。

CarrierInfo

表示运营商标准。

JSON 表示法 
{
  "carrierConstant": string
}
字段
carrierConstant

string

运营商常量资源名称。

OperatingSystemVersionInfo

表示要定位的操作系统版本。

JSON 表示法 
{
  "operatingSystemVersionConstant": string
}
字段
operatingSystemVersionConstant

string

操作系统版本常量资源名称。

MobileDeviceInfo

移动设备定位条件。

JSON 表示法 
{
  "mobileDeviceConstant": string
}
字段
mobileDeviceConstant

string

移动设备常量资源名称。

LocationGroupInfo

以通过 Feed 或 assetSet 指定的一系列营业地点为中心的半径范围。

JSON 表示法 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
字段
geoTargetConstants[]

string

用于限制 Feed 中地理区域范围的地理位置定位常量。目前仅允许使用一个地理位置定位常量。无法使用 AssetSet 字段进行设置。
radiusUnits

enum (LocationGroupRadiusUnits)

半径的单位。地理位置定位常量支持英里和米。Feed 项集和素材资源组支持毫英里和米数。这是必填字段，必须在 CREATE 操作中设置。
feedItemSets[]

string

已定位 FeedItem 的 FeedItemSet。如果指定了多个 ID，则系统会定位出现在至少一个 ID 集中的所有项。此字段无法与 geoTargetConstants 一起使用。这是可选内容，只能在 CREATE 操作中设置。无法使用 AssetSet 字段进行设置。
locationGroupAssetSets[]

string

已定位到其 Asset 的 AssetSet。如果指定了多个 ID，则系统会定位出现在至少一个 ID 集中的所有项。此字段无法与 Feed、地理位置定位常量或 Feed 项集一起使用。使用资源集时，应指定此字段或 enableCustomerLevelLocationAssetSet。这两者不能同时使用。此字段只能在 CREATE 操作中设置。
feed

string

用于指定要定位的地理位置的 Feed。无法使用 AssetSet 字段进行设置。这是必填字段，必须在 CREATE 操作中设置。
radius

string (int64 format)

以单位为单位的距离，用于指定定位到的地理位置的半径范围。这是必填字段，必须在 CREATE 操作中设置。
enableCustomerLevelLocationAssetSet

boolean

表示会将最新的客户级素材资源集用于定位。与 radius 和 radiusUnits 配合使用。无法与 Feed、地理位置定位常量或 Feed 项集一起使用。使用素材资源组时，应指定此字段或 locationGroupAssetSets。这两者不能同时使用。此字段只能在 CREATE 操作中设置。

LocationGroupRadiusUnits

营业地点组中的半径距离单位（例如 MILES）

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
METERS 米
MILES 英里
MILLI_MILES 毫英里

LocalServiceIdInfo

本地生活服务广告服务 ID。表示本地生活服务广告系列可以定位的服务类型（例如 install_faucet）。

JSON 表示法 
{
  "serviceId": string
}
字段
serviceId

string

条件资源名称。