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_MONTHS – חייב להיות 1
  • ‫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 לא מוגדר.