החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
Pacing
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הגדרות ששולטות בקצב שבו התקציב מנוצל.
| ייצוג ב-JSON |
{
"pacingPeriod": enum (PacingPeriod),
"pacingType": enum (PacingType),
// Union field daily_max_value can be only one of the following:
"dailyMaxMicros": string,
"dailyMaxImpressions": string
// End of list of possible types for union field daily_max_value.
} |
| שדות |
pacingPeriod |
enum (PacingPeriod)
חובה. התקופה שבה התקציב לניהול קצב ההוצאה ינוצל. כשהקצאת התקציב האוטומטית מופעלת בהזמנת ההצגה דרך automationType, השדה הזה משמש רק להצגת פלט והערך שמוגדר כברירת מחדל הוא PACING_PERIOD_FLIGHT.
|
pacingType |
enum (PacingType)
חובה. סוג הקצב שמגדיר את האופן שבו סכום התקציב ינוצל במהלך pacingPeriod. PACING_TYPE_ASAP לא תואם ל-pacingPeriod PACING_PERIOD_FLIGHT בהזמנות קמפיין.
|
שדה האיחוד daily_max_value. רלוונטי כאשר השדה pacing_period מוגדר כ-PACING_PERIOD_DAILY. הערך של daily_max_value יכול להיות רק אחת מהאפשרויות הבאות: |
dailyMaxMicros |
string (int64 format)
סכום המטבע המקסימלי להוצאה בכל יום, ב-micros של המטבע של המפרסם. רלוונטי כשהתקציב מבוסס על מטבע. הערך חייב להיות גדול מ-0. לדוגמה, אם רוצים להגדיר 1.5 יחידה רגילה של המטבע, צריך להגדיר את השדה הזה לערך 1500000. הערך שהוקצה יעוגל ליחידות חיוב שלמות של המטבע הרלוונטי לפי הכללים הבאים: כל ערך חיובי שקטן מיחידת חיוב אחת יעוגל כלפי מעלה ליחידת חיוב אחת, וכל ערך גדול מיחידת חיוב אחת יעוגל כלפי מטה לערך החיוב הקרוב ביותר. לדוגמה, אם היחידה לחיוב של המטבע היא 0.01, והשדה הזה מוגדר כ-10257770, הוא יעוגל כלפי מטה ל-10250000, ערך של 10.25. אם הערך מוגדר ל-505, הוא יעוגל מעלה ל-10,000, ערך של 0.01.
|
dailyMaxImpressions |
string (int64 format)
מספר החשיפות המקסימלי שיוצגו בכל יום. האפשרות הזו רלוונטית כשהתקציב מבוסס על חשיפות. הערך חייב להיות גדול מ-0.
|
PacingPeriod
תקופות זמן אפשריות שבהן יתבצע שימוש בסכום ההוצאה המתוזמן.
| טיפוסים בני מנייה (enum) |
PACING_PERIOD_UNSPECIFIED |
הערך של התקופה לא צוין או שהוא לא ידוע בגרסה הזו. |
PACING_PERIOD_DAILY |
הגדרת הקצב תיושם על בסיס יומי. |
PACING_PERIOD_FLIGHT |
הגדרת הקצב תחול על כל משך הטיסה. |
PacingType
| טיפוסים בני מנייה (enum) |
PACING_TYPE_UNSPECIFIED |
הערך של מצב הקצב לא צוין או שהוא לא ידוע בגרסה הזו. |
PACING_TYPE_AHEAD |
רלוונטי רק לתקופת הקצאת הקצב של PACING_PERIOD_FLIGHT. כשמשתמשים בקצב פרסום מואץ, המערכת מנסה להוציא את התקציב מהר יותר מאשר באופן שווה, כדי לוודא שכל התקציב ינוצל עד סוף תקופת הקמפיין. |
PACING_TYPE_ASAP |
לנצל את כל סכום התקציב לפריסת המודעות במהירות האפשרית. |
PACING_TYPE_EVEN |
להוציא סכום תקציב קבוע בכל תקופה. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["The Display & Video 360 API v4 beta includes settings to control budget spending rates. Key parameters are `pacingPeriod` (timeframe: daily or flight duration) and `pacingType` (spending mode: even, ahead, or ASAP). When `pacingPeriod` is daily, `dailyMaxMicros` or `dailyMaxImpressions` define the maximum daily budget. `dailyMaxMicros` applies to currency-based budgets and must be above zero, values will be rounded to whole billable units. `dailyMaxImpressions` refers to the max number of impressions to serve each day.\n"],null,["# Pacing\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PacingPeriod](#PacingPeriod)\n- [PacingType](#PacingType)\n\nSettings that control the rate at which a budget is spent.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pacingPeriod\": enum (/display-video/api/reference/rest/v4/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v4/Pacing#PacingType), // Union field `daily_max_value` can be only one of the following: \"dailyMaxMicros\": string, \"dailyMaxImpressions\": string // End of list of possible types for union field `daily_max_value`. } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pacingPeriod` | `enum (`[PacingPeriod](/display-video/api/reference/rest/v4/Pacing#PacingPeriod)`)` Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via [automationType](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrderBudget.FIELDS.automation_type), this field is output only and defaults to `PACING_PERIOD_FLIGHT`. |\n| `pacingType` | `enum (`[PacingType](/display-video/api/reference/rest/v4/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period) `PACING_PERIOD_FLIGHT` for insertion orders. |\n| Union field `daily_max_value`. Applicable when [pacing_period](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period) is set to be `PACING_PERIOD_DAILY`. `daily_max_value` can be only one of the following: ||\n| `dailyMaxMicros` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. |\n| `dailyMaxImpressions` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. |\n\nPacingPeriod\n------------\n\nPossible time periods used to spend to the pacing amount.\n\n| Enums ||\n|-----------------------------|------------------------------------------------------------------|\n| `PACING_PERIOD_UNSPECIFIED` | Period value is not specified or is unknown in this version. |\n| `PACING_PERIOD_DAILY` | The pacing setting will be applied on daily basis. |\n| `PACING_PERIOD_FLIGHT` | The pacing setting will be applied to the whole flight duration. |\n\nPacingType\n----------\n\nPossible pacing types.\n\n| Enums ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `PACING_TYPE_UNSPECIFIED` | Pacing mode value is not specified or is unknown in this version. |\n| `PACING_TYPE_AHEAD` | Only applicable to `PACING_PERIOD_FLIGHT` pacing period. Ahead pacing attempts to spend faster than evenly, to make sure the entire budget is spent by the end of the flight. |\n| `PACING_TYPE_ASAP` | Spend all of pacing budget amount as quick as possible. |\n| `PACING_TYPE_EVEN` | Spend a consistent budget amount every period of time. |"]]
