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

หน่วยเวลาที่เป็นไปได้

Enum
TIME_UNIT_UNSPECIFIED ไม่ได้ระบุค่าหน่วยเวลาหรือไม่รู้จักในเวอร์ชันนี้
TIME_UNIT_LIFETIME ความถี่สูงสุดจะใช้กับตลอดอายุของรายการโฆษณา
TIME_UNIT_MONTHS ความถี่สูงสุดจะมีผลกับจํานวนเดือน
TIME_UNIT_WEEKS ความถี่สูงสุดจะมีผลกับจำนวนสัปดาห์
TIME_UNIT_DAYS ความถี่สูงสุดจะมีผลกับจำนวนวัน
TIME_UNIT_HOURS ความถี่สูงสุดจะมีผลกับจำนวนชั่วโมง
TIME_UNIT_MINUTES ความถี่สูงสุดจะมีผลกับจำนวนนาที