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_MONTHS – должно быть равно 1.
  • TIME_UNIT_WEEKS – должно быть от 1 до 4.
  • TIME_UNIT_DAYS – должно быть от 1 до 6.
  • TIME_UNIT_HOURS – должно быть от 1 до 23.
  • TIME_UNIT_MINUTES – должно быть от 1 до 59.
maxImpressions

integer

Максимальное количество показов одного и того же объявления пользователю за этот период. Укажите значение больше нуля.

Обязательно, если unlimited – это false, а maxViews не задано.

maxViews

integer

Необязательное поле. Максимальное количество раз, которое пользователь может нажать на объявление или полностью его посмотреть в течение этого периода, прежде чем оно перестанет ему показываться. Укажите значение больше нуля.

Применимо только к ресурсам YouTube и партнерским видеоресурсам.

Обязательно, если unlimited – это false, а maxImpressions не задано.