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 轉換價值規則已暫停,但可以重新啟用。