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,
  "maxViews": 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à một người dùng có thể nhìn 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 và chưa đặt maxViews.

maxViews

integer

Số lần tối đa mà một người dùng có thể nhấp qua hoặc xem toàn bộ một quảng cáo trong khoảng thời gian này cho đến khi quảng cáo đó không còn được phân phát cho họ nữa. Phải lớn hơn 0.

Chỉ áp dụng cho các tài nguyên của YouTube và Đối tác.

Bắt buộc khi unlimitedfalse và chưa đặt maxImpressions.