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