FrequencyCap

Ustawienia określające, 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 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ń.

Wymagane, gdy unlimited ma wartość false.

timeUnitCount

integer

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

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

  • TIME_UNIT_LIFETIME – to pole dotyczy tylko danych wyjściowych i ma domyślnie wartość 1.
  • TIME_UNIT_MONTHS – musi się mieścić w zakresie 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.

Wymagany, gdy unlimited ma wartość false, a maxViews nie jest skonfigurowane.

maxViews

integer

Opcjonalnie: Maksymalna liczba kliknięć reklamy lub obejrzeń reklamy przez użytkownika w danym okresie, dopóki nie przestanie ona być wyświetlana. Musi być większy niż 0.

Dotyczy tylko zasobów YouTube i partnerów.

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