FrequencyCap

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

JSON-представление
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
Поля
unlimited

boolean

Применяется ли неограниченное ограничение частоты показов. Если для этого поля установлено значение true , остальные поля ограничения частоты показов неприменимы.

time Unit

enum ( TimeUnit )

Единица времени, в течение которой будет применяться ограничение частоты показов.

Требуется, если unlimited равно false .

time Unit Count

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.
max Impressions

integer

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

Требуется, если unlimited имеет значение false и maxViews не установлен.

max Views

integer

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

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

Требуется, если unlimited равно false и maxImpressions не установлен.