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_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보다 커야 합니다.

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

maxViews

integer

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

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

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