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 ו-Partner.

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