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