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 表示法 
{

  // Union field signal can be only one of the following:
  "impressionSignal": enum (ImpressionSignal),
  "clickSignal": enum (ClickSignal),
  "activeViewSignal": enum (ActiveViewSignal)
  // End of list of possible types for union field signal.
}
欄位
聯集欄位 signal。用來評估規則的信號。signal 只能是下列其中一項：
impressionSignal

enum (ImpressionSignal)

以曝光次數為依據的信號。
clickSignal

enum (ClickSignal)

根據點擊次數提供的信號。

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

enum (ActiveViewSignal)

根據 Active View 產生的信號。

這個欄位僅適用於許可合作夥伴。

ComparisonValue

要與信號比較的值。

JSON 表示法 
{

  // Union field value can be only one of the following:
  "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),
  "videoPlayerSizeValue": enum (VideoPlayerSize)
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。要與信號比較的值。value 只能是下列其中一項：
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)

換購價值。
videoPlayerSizeValue

enum (VideoPlayerSize)

影片播放器大小值。

這個欄位僅適用於許可合作夥伴。

DayAndTime

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

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

enum (DayOfWeek)

必要欄位。星期幾。
hourOfDay

integer

必要欄位。時段。
timeZoneResolution

enum (TimeZoneResolution)

必要欄位。用來判斷相關時區的機制。

SignalValue

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

JSON 表示法 
{

  // Union field signal can be only one of the following:
  "activeViewSignal": enum (ActiveViewSignal),
  "floodlightActivityConversionSignal": {
    object (FloodlightActivityConversionSignal)
  }
  // End of list of possible types for union field signal.
  "number": number
}
欄位
聯集欄位 signal。用於產生值的基本信號。signal 只能是下列其中一項：
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)

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