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 转化价值规则已暂停,但可以重新启用。