FrequencyCap

Các 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
}
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.

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 mà giới hạn tần suất sẽ kéo dài.

Bắt buộc khi unlimitedfalse. Các quy định 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ỉ có giá trị đầ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ộ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 unlimitedfalsemaxViews không được đặt.

maxViews

integer

Không bắt buộc. Số lần tối đa mà người dùng có thể nhấp vào hoặc xem hết 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.