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.