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