FrequencyCap

用于控制用户在指定时间段内看到同一广告的次数的设置。

JSON 表示法
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
字段
unlimited

boolean

是否应用了无频次上限。如果此字段设置为 true,则其余频次上限字段不适用。

timeUnit

enum (TimeUnit)

应用频次上限的时间单位。

unlimitedfalse 时,必须设置此参数。

timeUnitCount

integer

频次上限的持续时间(以 timeUnit 为单位)。

unlimitedfalse 时,必须设置此参数。以下限制适用于基于 timeUnit 值的情况:

  • TIME_UNIT_MONTHS - 必须为 1
  • TIME_UNIT_WEEKS - 必须介于 1 到 4 之间
  • TIME_UNIT_DAYS - 必须介于 1 到 6 之间
  • TIME_UNIT_HOURS - 必须介于 1 到 23 之间
  • TIME_UNIT_MINUTES - 必须介于 1 到 59 之间
maxImpressions

integer

在此期间,同一用户看到同一广告的次数上限。必须大于 0。

unlimitedfalse 且未设置 maxViews 时,此参数为必需参数。

maxViews

integer

可选。在此期间,用户可点击广告或完整观看广告的次数上限,达到此上限后,系统将不再向该用户投放相应广告。必须大于 0。

仅适用于 YouTube 和合作伙伴资源。

unlimitedfalse 且未设置 maxImpressions 时,此参数为必需参数。