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