FrequencyCap

這項設定可用來控制系統在特定時間範圍內,使用者看到同一則廣告的次數。

JSON 表示法
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer
}
欄位
unlimited

boolean

是否套用無限制的展示頻率上限。如果將這個欄位設為「true」,就無法套用其餘的展示頻率上限欄位。

timeUnit

enum (TimeUnit)

要套用展示頻率上限的時間單位。

如果 unlimitedfalse,則為必要欄位。

timeUnitCount

integer

展示頻率上限會最後一個timeUnit數。

如果 unlimitedfalse,則為必要欄位。根據 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。

如果 unlimitedfalse,則為必要欄位。

TimeUnit

可能的時間單位。

列舉
TIME_UNIT_UNSPECIFIED 未指定時間單位值,或這個版本不支援這個值。
TIME_UNIT_LIFETIME 展示頻率上限會套用到委刊項的整個效期。
TIME_UNIT_MONTHS 展示頻率上限會套用於數個月。
TIME_UNIT_WEEKS 展示頻率上限會套用於指定週數。
TIME_UNIT_DAYS 展示頻率上限會套用至指定天數。
TIME_UNIT_HOURS 展示頻率上限會套用到時數。
TIME_UNIT_MINUTES 展示頻率上限會套用於指定分鐘數。