FrequencyCap

特定の期間内に 1 人のユーザーに同じ広告を表示する回数を管理する設定です。

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

この期間中に 1 人のユーザーに同じ広告を表示する最大回数。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 フリークエンシー キャップは分単位で適用されます。