החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
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 – חייב להיות 1TIME_UNIT_WEEKS – הערך חייב להיות בין 1 ל-4TIME_UNIT_DAYS – חייב להיות בין 1 ל-6TIME_UNIT_HOURS – חייב להיות בין 1 ל-23TIME_UNIT_MINUTES – חייב להיות בין 1 ל-59
|
maxImpressions |
integer
המספר המקסימלי של פעמים שאותה מודעה עשויה להופיע בפני משתמש במהלך התקופה הזו. הערך חייב להיות גדול מ-0. חובה כאשר הערך של unlimited הוא false והערך של maxViews לא מוגדר.
|
maxViews |
integer
זה שינוי אופציונלי. המספר המקסימלי של הפעמים שמשתמש יכול ללחוץ על מודעה או לצפות בה במלואה במהלך התקופה הזו, עד שהמודעה לא תוצג לו יותר. הערך חייב להיות גדול מ-0. המבצע רלוונטי רק למשאבים של YouTube ושל שותפים. חובה כאשר הערך של unlimited הוא false והערך של maxImpressions לא מוגדר.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
