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)

基于有效观看次数的信号。

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

互斥字段的结束。

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)

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