FrequencyCap

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

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

이 기간 동안 사용자에게 동일한 광고가 게재될 수 있는 최대 횟수입니다. 0보다 커야 합니다.

unlimited이 false이고 maxViews가 설정되지 않은 경우 필요합니다.
maxViews

integer

선택사항입니다. 이 기간 동안 사용자가 광고를 더 이상 게재되지 않을 때까지 클릭하거나 완전히 볼 수 있는 최대 횟수입니다. 0보다 커야 합니다.

YouTube 및 파트너 리소스에만 적용됩니다.

unlimited이 false이고 maxImpressions가 설정되지 않은 경우 필요합니다.