自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明,请参阅我们的
弃用页面。
FrequencyCap
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
用于控制在指定时间段内向用户展示同一广告的次数的设置。
JSON 表示法 |
{
"unlimited": boolean,
"timeUnit": enum (TimeUnit ),
"timeUnitCount": integer,
"maxImpressions": integer,
"maxViews": integer
} |
字段 |
unlimited |
boolean
是否应用了无频次上限。如果此字段设置为 true ,则其余频次上限字段不适用。
|
timeUnit |
enum (TimeUnit )
应用频次上限的时间单位。 当 unlimited 为 false 时,必须设置此参数。
|
timeUnitCount |
integer
频次上限的有效期(以 timeUnit 为单位)。 当 unlimited 为 false 时,必须设置此参数。根据 timeUnit 的值,存在以下限制:
TIME_UNIT_MONTHS - 必须为 1
TIME_UNIT_WEEKS - 必须介于 1 到 4 之间
TIME_UNIT_DAYS - 必须介于 1 到 6 之间
TIME_UNIT_HOURS - 必须介于 1 到 23 之间
TIME_UNIT_MINUTES - 必须介于 1 到 59 之间
|
maxImpressions |
integer
在此时间段内向同一用户展示同一广告的次数上限。必须大于 0。 当 unlimited 为 false 且未设置 maxViews 时,此参数为必需参数。
|
maxViews |
integer
可选。在该时间段内,用户点击或完整观看广告的次数上限,在此之后系统便不会再向其投放该广告。必须大于 0。 仅适用于 YouTube 和合作伙伴资源。 当 unlimited 为 false 且未设置 maxImpressions 时,此参数为必需参数。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eFrequency capping settings determine how often a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings offer control over the maximum impressions or views a user receives within a defined period.\u003c/p\u003e\n"],["\u003cp\u003eYou can set frequency caps based on various time units (lifetime, months, weeks, days, hours, minutes) and limits.\u003c/p\u003e\n"],["\u003cp\u003eThe "unlimited" option bypasses other frequency cap settings, allowing for unlimited ad exposure.\u003c/p\u003e\n"],["\u003cp\u003eFor YouTube and Partner resources, you can set limits for both impressions (ad displays) and views (clicks or full views).\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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/v3/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/v3/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v3/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/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v3/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/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_impressions) is not set. |"]]