AlgorithmRules

規則式演算法。

JSON 表示法 
{
  "impressionSignalRuleset": {
    object (Ruleset)
  },
  "postImpressionSignalRuleset": {
    object (Ruleset)
  },
  "attributionModelId": string
}
欄位
impressionSignalRuleset

object (Ruleset)

曝光信號的規則。
postImpressionSignalRuleset

object (Ruleset)

曝光後信號的規則。

這個欄位僅適用於許可清單中的合作夥伴。
attributionModelId

string (int64 format)

演算法的歸因模式。

這個欄位僅適用於許可清單中的合作夥伴。

規則集

規則集，包含規則清單和結果值的匯總方式。

JSON 表示法 
{
  "rules": [
    {
      object (Rule)
    }
  ],
  "aggregationType": enum (RuleAggregationType),
  "maxValue": number
}
欄位
rules[]

object (Rule)

用於產生曝光價值的規則清單。
aggregationType

enum (RuleAggregationType)

如何匯總已評估規則的值。
maxValue

number

規則集可評估的最大值。

規則

一組條件。

規則的傳回值為下列其中一項：

  • 符合單一條件時傳回的值，或
  • 如果未符合任何條件，則傳回定義的預設值。
JSON 表示法 
{
  "conditions": [
    {
      object (RuleCondition)
    }
  ],
  "defaultReturnValue": {
    object (SignalValue)
  }
}
欄位
conditions[]

object (RuleCondition)

這項規則中的條件清單。條件之間的條件應互斥。
defaultReturnValue

object (SignalValue)

不符合任何條件時，系統會套用預設傳回值。

RuleCondition

一組信號比較。等同於 if 陳述式。

JSON 表示法 
{
  "signalComparisons": [
    {
      object (SignalComparison)
    }
  ],
  "returnValue": {
    object (SignalValue)
  }
}
欄位
signalComparisons[]

object (SignalComparison)

用於建構 if 陳述式條件的比較項目清單。比較結果會與 AND 邏輯運算子合併為單一條件。
returnValue

object (SignalValue)

如果 signalComparisons 條件評估為 TRUE，則傳回這個值。

SignalComparison

單一比較項目。比較 signal 和 comparisonValue。

siteId==123 的比較結果會以下列欄位值表示：

  • signal的impressionSignal為 SITE_ID。
  • comparisonOperator 設為 EQUAL。
  • comparisonValue 設為 123。
JSON 表示法 
{
  "signal": {
    object (Signal)
  },
  "comparisonOperator": enum (ComparisonOperator),
  "comparisonValue": {
    object (ComparisonValue)
  }
}
欄位
signal

object (Signal)

要比較的信號。
comparisonOperator

enum (ComparisonOperator)

用於比較兩個值的運算子。

在產生的運算式中，signal 將是第一個值，而 `comparisonValue 則是第二個值。
comparisonValue

object (ComparisonValue)

要與信號比較的值。

信號

用於評估規則的信號。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressionSignal": enum (ImpressionSignal),
  "clickSignal": enum (ClickSignal),
  "activeViewSignal": enum (ActiveViewSignal)
  // End of mutually exclusive fields.
}
欄位
用於評估規則的信號。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
impressionSignal

enum (ImpressionSignal)

根據曝光次數的信號。
clickSignal

enum (ClickSignal)

根據點擊次數的信號。

這個欄位僅適用於許可清單中的合作夥伴。
activeViewSignal

enum (ActiveViewSignal)

根據 Active View 產生的信號。

這個欄位僅適用於許可清單中的合作夥伴。
互斥欄位結束。

ComparisonValue

要與信號比較的值。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "creativeDimensionValue": {
    object (Dimensions)
  },
  "dayAndTimeValue": {
    object (DayAndTime)
  },
  "deviceTypeValue": enum (RuleDeviceType),
  "onScreenPositionValue": enum (OnScreenPosition),
  "environmentValue": enum (Environment),
  "exchangeValue": enum (Exchange),
  "contentDurationValue": enum (ContentDuration),
  "contentStreamTypeValue": enum (ContentStreamType),
  "contentGenreIdValue": string,
  "videoPlayerSizeValue": enum (VideoPlayerSize)
  // End of mutually exclusive fields.
}
欄位
要與信號比較的值。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
int64Value

string (int64 format)

整數值。
doubleValue

number

雙重值。
stringValue

string

字串值。
boolValue

boolean

布林值。
creativeDimensionValue

object (Dimensions)

廣告素材尺寸值。
dayAndTimeValue

object (DayAndTime)

日期和時間值。僅支援 TIME_ZONE_RESOLUTION_END_USER。
deviceTypeValue

enum (RuleDeviceType)

裝置類型值。
onScreenPositionValue

enum (OnScreenPosition)

廣告排序值。
environmentValue

enum (Environment)

環境值。
exchangeValue

enum (Exchange)

換購價值。
contentDurationValue

enum (ContentDuration)

影片內容長度值。
contentStreamTypeValue

enum (ContentStreamType)

影片放送類型值。
contentGenreIdValue

string (int64 format)

影片類型 ID 值。
videoPlayerSizeValue

enum (VideoPlayerSize)

影片播放器大小值。

這個欄位僅適用於許可清單中的合作夥伴。
互斥欄位結束。

DayAndTime

以星期幾和時段定義的時間表示法。

JSON 表示法 
{
  "dayOfWeek": enum (DayOfWeek),
  "hourOfDay": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
欄位
dayOfWeek

enum (DayOfWeek)

必填。星期幾。
hourOfDay

integer

必填。時段。
timeZoneResolution

enum (TimeZoneResolution)

必填。用來判斷相關時區的機制。

SignalValue

用於評估規則的信號調整值。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activeViewSignal": enum (ActiveViewSignal),
  "floodlightActivityConversionSignal": {
    object (FloodlightActivityConversionSignal)
  }
  // End of mutually exclusive fields.
  "number": number
}
欄位
用於產生值的基本信號。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
activeViewSignal

enum (ActiveViewSignal)

根據 Active View 產生的信號。僅支援 TIME_ON_SCREEN。

這個欄位僅支援許可清單中的合作夥伴。
floodlightActivityConversionSignal

object (FloodlightActivityConversionSignal)

根據 Floodlight 轉換事件建立的信號。

這個欄位僅適用於許可清單中的合作夥伴。
互斥欄位結束。
number

number

要用做結果的值。

FloodlightActivityConversionSignal

根據 Floodlight 轉換事件為曝光評分的規則。

JSON 表示法 
{
  "floodlightActivityId": string,
  "countingMethod": enum (CountingMethod),
  "conversionCounting": enum (ConversionCounting)
}
欄位
floodlightActivityId

string (int64 format)

必填。Floodlight 活動 ID。
countingMethod

enum (CountingMethod)

必填。從 Floodlight 活動取得價值的方式，例如轉換次數。
conversionCounting

enum (ConversionCounting)

必填。用於計算曝光價值的轉換類型，例如點擊後轉換。