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 .

Единица времени

Возможные единицы времени.

Перечисления
TIME_UNIT_UNSPECIFIED Значение единицы времени в этой версии не указано или неизвестно.
TIME_UNIT_LIFETIME Ограничение частоты показов будет применяться на протяжении всего срока действия позиции.
TIME_UNIT_MONTHS Ограничение частоты будет применяться к нескольким месяцам.
TIME_UNIT_WEEKS Ограничение частоты будет применяться в течение нескольких недель.
TIME_UNIT_DAYS Ограничение частоты будет применяться к нескольким дням.
TIME_UNIT_HOURS Ограничение частоты будет применяться к определенному количеству часов.
TIME_UNIT_MINUTES Ограничение частоты будет применяться к определенному количеству минут.