FrequencyCap

الإعدادات التي تتحكّم في عدد مرّات عرض المستخدِم مع الإعلان نفسه خلال فترة زمنية معيّنة.

تمثيل JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": 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".

TimeUnit

وحدات زمنية محتملة.

عمليات التعداد
TIME_UNIT_UNSPECIFIED قيمة الوحدة الزمنية غير محدّدة أو غير معروفة في هذا الإصدار.
TIME_UNIT_LIFETIME سيتم تطبيق عدد مرات الظهور على المدة الكاملة للعنصر.
TIME_UNIT_MONTHS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأشهر.
TIME_UNIT_WEEKS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأسابيع.
TIME_UNIT_DAYS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأيام.
TIME_UNIT_HOURS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الساعات.
TIME_UNIT_MINUTES سيتم تطبيق تحديد عدد مرات الظهور على عدد من الدقائق.