FrequencyCap

特定の期間中に同じユーザーに同じ広告が表示される回数を制御する設定。

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_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 より大きくする必要があります。

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

maxViews

integer

省略可。この期間中にユーザーが広告をクリックまたは完全に視聴できる回数の上限。この上限に達すると、そのユーザーには広告が表示されなくなります。0 より大きくする必要があります。

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

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