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

僅供輸出。轉換價值規則擁有者客戶的資源名稱。價值規則繼承自管理員客戶後,擁有者客戶就會是管理員的資源名稱,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 轉換價值規則已暫停,但可重新啟用。