Kể từ
ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem
trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
FrequencyCap
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 unlimited là false .
|
timeUnitCount |
integer
Số timeUnit mà giới hạn tần suất sẽ kéo dài. Bắt buộc khi unlimited là false . Các quy định hạn chế sau đây áp dụng dựa trên giá trị của timeUnit :
TIME_UNIT_MONTHS – phải là 1
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 unlimited là false và maxViews 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 unlimited là false và maxImpressions không được đặt.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# FrequencyCap\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v4/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v4/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_impressions) is not set. |"]]