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 לא מוגדר.