FrequencyCap

일정 기간 동안 사용자에게 동일한 광고가 게재될 수 있는 횟수를 제어하는 설정입니다.

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

이 기간 동안 사용자에게 동일한 광고가 게재될 수 있는 최대 횟수입니다. 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 최대 게재빈도가 분 단위로 적용됩니다.