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.