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.