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),
  "contentDurationValue": enum (ContentDuration),
  "contentStreamTypeValue": enum (ContentStreamType),
  "contentGenreIdValue": string,
  "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)

換購價值。
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 表示法 
{

  // 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)

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