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 최대 게재빈도는 분 단위로 적용됩니다.