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_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。

如果 unlimitedfalse 且未设置 maxViews,则必须提供此值。

maxViews

integer

用户在这段时间内点击或完整观看广告(直至广告不再向其投放)的次数上限。必须大于 0。

此问题仅会影响 YouTube 和合作伙伴资源。

如果 unlimitedfalse 且未设置 maxImpressions,则必须提供此值。