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가 설정되지 않은 경우 필요합니다.