FrequencyCap

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

JSON 表現
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
フィールド
unlimited

boolean

無制限のフリークエンシー キャップが適用されるかどうか。このフィールドを true に設定した場合、残りのフリークエンシー キャップ フィールドは適用されません。

timeUnit

enum (TimeUnit)

フリークエンシー キャップが適用される時間単位。

unlimitedfalse の場合は必須です。

timeUnitCount

integer

フリークエンシー キャップが持続する timeUnit の数。

unlimitedfalse の場合は必須です。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 より大きくする必要があります。

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

maxViews

integer

広告が配信されなくなるまでに、ユーザーがこの期間内に広告をクリックまたは完全に表示した回数の上限。0 より大きくする必要があります。

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

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