FrequencyCap

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

ייצוג JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": 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 ו-maxViews לא מוגדר.
maxViews

integer

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

רלוונטי רק למשאבים של YouTube ושל שותפים.

חובה כאשר unlimited הוא false ו-maxImpressions לא מוגדר.