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 ו-Google Partners.

חובה אם הערך של unlimited הוא false ואם הערך של maxImpressions לא מוגדר.