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，則為必要欄位。