FrequencyCap

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

Bắt buộc khi unlimitedfalse.

timeUnitCount

integer

Số timeUnit mà giới hạn tần suất sẽ không tồn tại.

Bắt buộc khi unlimitedfalse. Các quy định hạn chế sau áp dụng dựa trên giá trị của timeUnit:

  • TIME_UNIT_LIFETIME – trường này chỉ là kết quả xuất dữ liệu 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ể 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 unlimitedfalsemaxViews chưa được đặt.

maxViews

integer

Số lần tối đa mà 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 unlimitedfalsemaxImpressions chưa được đặt.