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_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，且未設定 maxViews，則為必要欄位。
maxViews

integer

使用者在這段時間內點閱或完整觀看廣告的次數上限，直到廣告停止放送為止。必須大於 0。

僅適用於 YouTube 與合作夥伴資源。

如果 unlimited 為 false，且未設定 maxImpressions，則為必要欄位。