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