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 展示頻率上限會套用到幾分鐘。