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".