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
}
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 to false.

TimeUnit

Możliwe jednostki czasu.

Wartości w polu enum
TIME_UNIT_UNSPECIFIED Wartość jednostki czasu nie jest określona lub jest nieznana w tej wersji.
TIME_UNIT_LIFETIME Limit wyświetleń na użytkownika zostanie zastosowany do całego okresu aktywności elementu zamówienia.
TIME_UNIT_MONTHS Limit wyświetleń na użytkownika zostanie zastosowany na kilku miesiącach.
TIME_UNIT_WEEKS Limit wyświetleń na użytkownika zostanie zastosowany na kilku tygodniach.
TIME_UNIT_DAYS Limit wyświetleń na użytkownika zostanie zastosowany na kilku dniach.
TIME_UNIT_HOURS Limit wyświetleń na użytkownika zostanie zastosowany do określonej liczby godzin.
TIME_UNIT_MINUTES Limit wyświetleń na użytkownika zostanie zastosowany do określonej liczby minut.