FrequencyCap

Chế độ cài đặt kiểm soát số lần một người dùng có thể xuất hiện cùng với cùng một quảng cáo trong một khoảng thời gian nhất định.

Biểu diễn dưới dạng JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer
}
Các trường
unlimited

boolean

Liệu giới hạn tần suất không giới hạn có được áp dụng hay không. Khi bạn đặt trường này thành true, các trường giới hạn tần suất còn lại sẽ không áp dụng được.
timeUnit

enum (TimeUnit)

Đơn vị thời gian mà giới hạn tần suất sẽ được áp dụng.

Bắt buộc khi unlimited là false.
timeUnitCount

integer

Số lượng timeUnit giới hạn tần suất sẽ kéo dài.

Bắt buộc khi unlimited là false. Các hạn chế sau đây được áp dụng dựa trên giá trị của timeUnit:

  • TIME_UNIT_LIFETIME – trường này chỉ là kết quả đầu ra và sẽ mặc định là 1
  • TIME_UNIT_MONTHS – phải nằm trong khoảng từ 1 đến 2
  • TIME_UNIT_WEEKS – phải nằm trong khoảng từ 1 đến 4
  • TIME_UNIT_DAYS – phải nằm trong khoảng từ 1 đến 6
  • TIME_UNIT_HOURS – phải nằm trong khoảng từ 1 đến 23
  • TIME_UNIT_MINUTES – phải nằm trong khoảng từ 1 đến 59
maxImpressions

integer

Số lần tối đa mà một người dùng có thể thấy cùng một quảng cáo trong khoảng thời gian này. Phải lớn hơn 0.

Bắt buộc khi unlimited là false.

TimeUnit

Đơn vị thời gian có thể sử dụng.

Enum
TIME_UNIT_UNSPECIFIED Giá trị đơn vị thời gian không được chỉ định hoặc không xác định trong phiên bản này.
TIME_UNIT_LIFETIME Giới hạn tần suất sẽ được áp dụng cho toàn bộ thời gian hoạt động của mục hàng.
TIME_UNIT_MONTHS Giới hạn tần suất sẽ được áp dụng cho một số tháng.
TIME_UNIT_WEEKS Giới hạn tần suất sẽ được áp dụng cho một số tuần.
TIME_UNIT_DAYS Giới hạn tần suất sẽ được áp dụng cho một số ngày.
TIME_UNIT_HOURS Giới hạn tần suất sẽ được áp dụng cho một số giờ.
TIME_UNIT_MINUTES Giới hạn tần suất sẽ được áp dụng cho số phút.