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 będzie stosowany limit wyświetleń na użytkownika.

Wymagane, gdy unlimited ma wartość false.

timeUnitCount

integer

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

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

  • TIME_UNIT_LIFETIME – to pole zawiera tylko dane wyjściowe, a domyślnie przyjmuje wartość 1
  • TIME_UNIT_MONTHS – musi mieścić się w przedziale od 1 do 2
  • TIME_UNIT_WEEKS – musi mieścić się w przedziale od 1 do 4
  • TIME_UNIT_DAYS – musi mieścić się w przedziale od 1 do 6
  • TIME_UNIT_HOURS – musi mieścić się w przedziale od 1 do 23
  • TIME_UNIT_MINUTES – musi mieścić się w przedziale 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 możliwości kliknięcia i obejrzenia reklamy przez użytkownika w tym okresie do momentu, gdy przestanie się ona mu wyświetlać. 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.