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)

基于有效观看的信号。

此字段仅适用于列入许可名单的合作伙伴。

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)

基于有效观看的信号。仅支持 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)

必需。用于计算展示价值的转化类型，例如点击后转化。