FrequencyCap

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

JSON 表示法 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": 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，则必须提供此值。

TimeUnit

可能的时间单位。

枚举
TIME_UNIT_UNSPECIFIED 该版本中未指定时间单位值或时间单位值未知。
TIME_UNIT_LIFETIME 频次上限将应用于订单项的整个生命周期。
TIME_UNIT_MONTHS 频次上限将应用于月数。
TIME_UNIT_WEEKS 频次上限会应用到数周内，
TIME_UNIT_DAYS 频次上限会应用于天数。
TIME_UNIT_HOURS 频次上限将应用于小时数。
TIME_UNIT_MINUTES 频次上限将应用于分钟数。