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