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 が設定されていない場合は必須。