ConversionValueRule

转化价值规则

JSON 表示法
{
  "resourceName": string,
  "id": string,
  "action": {
    object (ValueRuleAction)
  },
  "geoLocationCondition": {
    object (ValueRuleGeoLocationCondition)
  },
  "deviceCondition": {
    object (ValueRuleDeviceCondition)
  },
  "audienceCondition": {
    object (ValueRuleAudienceCondition)
  },
  "ownerCustomer": string,
  "status": enum (ConversionValueRuleStatus)
}
字段
resourceName

string

不可变。转化价值规则的资源名称。转化价值规则资源名称的格式为:

customers/{customerId}/conversionValueRules/{conversion_value_rule_id}

id

string (int64 format)

仅限输出。转化价值规则的 ID。

action

object (ValueRuleAction)

在规则触发时执行的操作。

geoLocationCondition

object (ValueRuleGeoLocationCondition)

地理位置条件,必须满足此条件才能应用价值规则。

deviceCondition

object (ValueRuleDeviceCondition)

设备类型的条件,必须满足此条件才能应用值规则。

audienceCondition

object (ValueRuleAudienceCondition)

受众群体必须满足的条件,否则价值规则将不适用。

ownerCustomer

string

仅限输出。转化价值规则的所有者客户的资源名称。当价值规则继承自经理客户时,ownerCustomer 将是经理的资源名称,而 resourceName 中的客户是提出请求的投放客户。** 只读 **

status

enum (ConversionValueRuleStatus)

转化价值规则的状态。

ValueRuleAction

应用规则时执行的操作。

JSON 表示法
{
  "operation": enum (ValueRuleOperation),
  "value": number
}
字段
operation

enum (ValueRuleOperation)

指定应用的操作。

value

number

指定应用的值。

ValueRuleOperation

转化价值规则操作的可能操作。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ADD 将提供的价值添加到转化价值。
MULTIPLY 将转化价值乘以指定的值。
SET 将转化价值设置为所提供的价值。

ValueRuleGeoLocationCondition

基于地理位置维度设置的条件。

JSON 表示法
{
  "excludedGeoTargetConstants": [
    string
  ],
  "excludedGeoMatchType": enum (ValueRuleGeoLocationMatchType),
  "geoTargetConstants": [
    string
  ],
  "geoMatchType": enum (ValueRuleGeoLocationMatchType)
}
字段
excludedGeoTargetConstants[]

string

广告客户要排除的地理位置。

excludedGeoMatchType

enum (ValueRuleGeoLocationMatchType)

排除的地理位置匹配类型。

geoTargetConstants[]

string

广告客户想要包含的地理位置。

geoMatchType

enum (ValueRuleGeoLocationMatchType)

包含的地理位置匹配类型。

ValueRuleGeoLocationMatchType

可能的地理位置匹配类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ANY 您可以使用“感兴趣的区域”或“所在地”进行匹配。
LOCATION_OF_PRESENCE 只能使用“当前所在位置”进行匹配。

ValueRuleDeviceCondition

“设备端使用情况”维度。

JSON 表示法
{
  "deviceTypes": [
    enum (ValueRuleDeviceType)
  ]
}
字段
deviceTypes[]

enum (ValueRuleDeviceType)

设备类型条件的值。

ValueRuleDeviceType

转化价值规则中可能使用的设备类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
MOBILE 移动设备。
DESKTOP 桌面设备。
TABLET 平板电脑设备。

ValueRuleAudienceCondition

基于受众群体维度的条件。

JSON 表示法
{
  "userLists": [
    string
  ],
  "userInterests": [
    string
  ]
}
字段
userLists[]

string

用户名单。

userInterests[]

string

用户兴趣。

ConversionValueRuleStatus

转化价值规则的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 转化价值规则已启用,可以应用。
REMOVED 转化价值规则已被永久删除,无法应用。
PAUSED 转化价值规则已暂停,但可重新启用。