FrequencyCap

הגדרות שקובעות כמה פעמים ניתן להציג למשתמש את אותה מודעה במהלך תקופת זמן נתונה.

ייצוג JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer
}
שדות
unlimited

boolean

אם הוחלה מכסת תדירות בלתי מוגבלת. אם השדה הזה מוגדר ל-true, שאר השדות של מכסת התדירות לא רלוונטיים.
timeUnit

enum (TimeUnit)

יחידת הזמן שבה תחול מכסת התדירות.

חובה כאשר unlimited הוא false.
timeUnitCount

integer

מספר הtimeUnit שמכסת התדירות תימשך.

חובה כאשר unlimited הוא false. ההגבלות הבאות חלות על הערך של timeUnit:

  • TIME_UNIT_LIFETIME - השדה הזה הוא פלט בלבד וברירת המחדל שלו תהיה 1
  • TIME_UNIT_MONTHS – חייב להיות בין 1 ל-2
  • TIME_UNIT_WEEKS – חייב להיות בין 1 ל-4
  • TIME_UNIT_DAYS – חייב להיות בין 1 ל-6
  • TIME_UNIT_HOURS – חייב להיות בין 1 ל-23
  • TIME_UNIT_MINUTES – חייב להיות בין 1 ל-59
maxImpressions

integer

מספר הפעמים המקסימלי שאותה מודעה יכולה להופיע בפני משתמש במהלך התקופה הזו. חייב להיות גדול מ-0.

חובה כאשר unlimited הוא false.

TimeUnit

יחידות זמן אפשריות.

טיפוסים בני מנייה (enums)
TIME_UNIT_UNSPECIFIED לא צוין ערך של יחידת זמן או שהוא לא ידוע בגרסה הזו.
TIME_UNIT_LIFETIME מכסת התדירות תחול על כל משך החיים של הפריט.
TIME_UNIT_MONTHS מכסת התדירות תחול על מספר חודשים.
TIME_UNIT_WEEKS מכסת התדירות תחול על מספר שבועות.
TIME_UNIT_DAYS מכסת התדירות תחול על מספר ימים.
TIME_UNIT_HOURS מכסת התדירות תחול על מספר שעות.
TIME_UNIT_MINUTES מכסת התדירות תחול למשך כמה דקות.