FrequencyCap

Chế độ cài đặt kiểm soát số lần người dùng có thể thấy 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
}
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 áp dụng giới hạn tần suất.

Bắt buộc khi unlimitedfalse.

timeUnitCount

integer

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

Bắt buộc khi unlimitedfalse. 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ỉ dành cho kết quả đầu ra và sẽ được đặt 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ộ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 unlimitedfalse.

TimeUnit

Đơn vị thời gian có thể dùng.

Enum
TIME_UNIT_UNSPECIFIED Giá trị đơn vị thời gian chưa đượ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.