FrequencyCap

• تمثيل JSON

الإعدادات التي تتحكّم في عدد المرات التي قد يتم فيها عرض الإعلان نفسه للمستخدم خلال فترة زمنية معيّنة

تمثيل 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.