FrequencyCap

Ustawienia, które określają, ile razy ta sama reklama może się wyświetlić użytkownikowi w danym okresie.

Zapis JSON
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
Pola
unlimited

boolean

Określa, czy stosowane jest nieograniczone ograniczenie liczby wyświetleń. Gdy to pole ma wartość true, pozostałe pola limitu wyświetleń na użytkownika nie mają zastosowania.

timeUnit

enum (TimeUnit)

Jednostka czasu, w której zostanie zastosowany limit wyświetleń na użytkownika.

Wymagane, gdy unlimited ma wartość false.

timeUnitCount

integer

Liczba timeUnit, która będzie obowiązywać ograniczenie liczby wyświetleń.

Wymagane, gdy unlimited ma wartość false. W zależności od wartości timeUnit obowiązują te ograniczenia:

  • TIME_UNIT_LIFETIME – to pole jest tylko wyjściowe i ma wartość domyślną 1;
  • TIME_UNIT_MONTHS – musi mieścić się w zakresie od 1 do 2
  • TIME_UNIT_WEEKS – musi mieścić się w zakresie od 1 do 4
  • TIME_UNIT_DAYS – musi mieścić się w zakresie od 1 do 6
  • TIME_UNIT_HOURS – musi mieścić się w zakresie od 1 do 23
  • TIME_UNIT_MINUTES – musi mieścić się w zakresie od 1 do 59
maxImpressions

integer

Maksymalna liczba wyświetleń tej samej reklamy użytkownikowi w tym okresie. Musi być większy niż 0.

Wymagane, gdy unlimited ma wartość false, a maxViews nie jest ustawiony.

maxViews

integer

Maksymalna liczba razy, gdy użytkownik może w tym okresie kliknąć lub obejrzeć reklamę w całości, dopóki nie zostanie mu ona wyświetlona. Musi być większy niż 0.

Dotyczy tylko zasobów YouTube i partnerów.

Wymagane, gdy unlimited ma wartość false, a maxImpressions nie jest ustawiony.