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órym ograniczenie liczby wyświetleń zostanie zastosowane.

Wymagany, gdy unlimited to false.

timeUnitCount

integer

Liczba wartości, w jakiej będzie obowiązywał limit wyświetleń na użytkownika (timeUnit).

Wymagany, gdy unlimited to 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 mieścić się 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

Maksymalna liczba kliknięć reklamy w całości lub jej kliknięcia w tym 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 maxImpressions nie jest skonfigurowane.