FrequencyCap

用于控制同一广告在给定时间段内向同一用户展示的次数的设置。

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

boolean

是否应用无限制的频次上限。当此字段设置为 true 时，剩余的频次上限字段将不适用。
timeUnit

enum (TimeUnit)

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

当 unlimited 为 false 时，此字段为必需参数。
timeUnitCount

integer

频次上限所持续的 timeUnit 数。

当 unlimited 为 false 时，此字段为必需参数。根据 timeUnit 的值，存在以下限制：

  • TIME_UNIT_LIFETIME - 此字段是输出字段，默认值为 1
  • TIME_UNIT_MONTHS - 必须介于 1 到 2 之间
  • TIME_UNIT_WEEKS - 必须介于 1 到 4 之间
  • TIME_UNIT_DAYS - 必须介于 1 到 6 之间
  • TIME_UNIT_HOURS - 必须介于 1 到 23 之间
  • TIME_UNIT_MINUTES - 必须介于 1 到 59 之间
maxImpressions

integer

在此时间段内，同一广告向同一用户展示的次数上限。必须大于 0。

当 unlimited 为 false 且未设置 maxViews 时，是必需的。
maxViews

integer

在系统停止向用户展示广告之前，用户在这段时间内点击或完整观看广告的最大次数。必须大于 0。

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

当 unlimited 为 false 且未设置 maxImpressions 时，是必需的。