از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (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 و Partners قابل اجرا است. زمانی که unlimited false است و maxImpressions تنظیم نشده است، الزامی است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]