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