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.