FrequencyCap

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

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

この期間中に 1 人のユーザーに同じ広告を表示できる最大回数。0 より大きくなければなりません。

unlimited が false で、maxViews が設定されていない場合は必須です。
maxViews

integer

広告が配信されなくなるまで、この期間中に 1 人のユーザーに広告をクリックした、またはすべて表示した最大回数。0 より大きくなければなりません。

YouTube とパートナーのリソースにのみ適用されます。

unlimited が false で、maxImpressions が設定されていない場合は必須です。