FrequencyCap

Ustawienia, które określają, ile razy użytkownik może zobaczyć tę samą reklamę w danym okresie.

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

boolean

Określa, czy zastosowano 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.

Wymagany, gdy wartość atrybutu unlimited to false.

timeUnitCount

integer

Liczba timeUnit, przez którą będzie obowiązywać limit wyświetleń na użytkownika.

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

  • TIME_UNIT_MONTHS – musi mieć wartość 1
  • 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 wartość maxViews nie jest ustawiona.

maxViews

integer

Opcjonalnie. Maksymalna liczba kliknięć lub pełnych wyświetleń reklamy przez użytkownika w tym okresie, po której reklama przestanie być mu wyświetlana. Musi być większy niż 0.

Dotyczy tylko zasobów YouTube i sieci partnerów wideo Google.

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