FrequencyCap

Chế độ cài đặt kiểm soát số lần hiển thị cùng một quảng cáo cho một người dùng 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 có áp dụng giới hạn tần suất không giới hạn 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.
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ố timeUnit giới hạn tần suất sẽ hết hiệu lực.

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

  • TIME_UNIT_LIFETIME – trường này chỉ để xuất 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 trong khoảng từ 1 đến 59
maxImpressions

integer

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

Bắt buộc khi unlimited là false và chưa đặt maxViews.
maxViews

integer

Số lần tối đa người dùng có thể nhấp qua hoặc xem toàn bộ 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 unlimited là false và chưa đặt maxImpressions.