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
}
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 zostanie zastosowany limit wyświetleń na użytkownika.

Wymagane, gdy unlimited ma wartość false.
timeUnitCount

integer

Wartość (timeUnit) obowiązywania limitu wyświetleń na użytkownika.

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 i domyślnie przyjmuje 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ń reklamy użytkownikowi w tym okresie. Musi być większy niż 0.

Wymagane, gdy unlimited ma wartość false.

TimeUnit

Możliwe jednostki czasu.

Wartości w polu enum
TIME_UNIT_UNSPECIFIED Wartość jednostki czasu nie jest określona lub nieznana w tej wersji.
TIME_UNIT_LIFETIME Limit wyświetleń na użytkownika będzie stosowany do całego okresu aktywności elementu zamówienia.
TIME_UNIT_MONTHS Limit wyświetleń na użytkownika będzie obowiązywał w odniesieniu do kilku miesięcy.
TIME_UNIT_WEEKS Limit wyświetleń na użytkownika będzie obowiązywał przez kilka tygodni.
TIME_UNIT_DAYS Limit wyświetleń na użytkownika zostanie zastosowany do określonej liczby dni.
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 liczby minut.