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)

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