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 - باید ۱ باشد
  • TIME_UNIT_WEEKS - باید بین ۱ تا ۴ باشد
  • TIME_UNIT_DAYS - باید بین ۱ تا ۶ باشد
  • ‫TIME_UNIT_HOURS - باید بین ۱ تا ۲۳ باشد
  • TIME_UNIT_MINUTES - باید بین ۱ تا ۵۹ باشد
maxImpressions

integer

حداکثر تعداد دفعاتی که ممکن است یک آگهی درطول این دوره به کاربر نشان داده شود. باید بزرگ‌تر از ۰ باشد.

وقتی unlimited روی false تنظیم شده باشد و maxViews تنظیم نشده باشد، الزامی است.

maxViews

integer

اختیاری. حداکثر تعداد دفعاتی که کاربر می‌تواند درطول این دوره روی آگهی کلیک کند یا آن را به‌طور کامل مشاهده کند تا زمانی که دیگر به او ارائه نشود. باید بزرگ‌تر از ۰ باشد.

فقط برای منابع YouTube و «شرکا» قابل اعمال است.

وقتی unlimited روی false تنظیم شده باشد و maxImpressions تنظیم نشده باشد، الزامی است.