از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
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) حداکثر مقدار ارزی که باید هر روز در میکرو ارز تبلیغ‌کننده خرج کنید. زمانی که بودجه مبتنی بر ارز باشد قابل اجرا است. باید بزرگتر از 0 باشد. برای مثال، برای 1.5 واحد استاندارد واحد پول، این فیلد را روی 1500000 قرار دهید. ارزش تخصیصی به کل واحدهای قابل پرداخت برای ارز مربوطه بر اساس قوانین زیر گرد می شود: هر مقدار مثبت کمتر از یک واحد قابل پرداخت به یک واحد قابل پرداخت و هر مقدار بزرگتر از یک واحد قابل پرداخت به نزدیکترین ارزش قابل پرداخت به پایین گرد می شود. به عنوان مثال، اگر واحد قابل پرداخت ارز 0.01 باشد و این فیلد روی 10257770 تنظیم شده باشد، به 10250000، یعنی مقدار 10.25، گرد می شود. اگر روی 505 تنظیم شود، تا 10000 گرد می شود، مقدار 0.01. |
dailyMaxImpressions | string ( int64 format) حداکثر تعداد نمایش برای ارائه هر روز. زمانی که بودجه مبتنی بر برداشت است، قابل اجرا است. باید بزرگتر از 0 باشد. |
دوره ضربان
دوره‌های زمانی احتمالی که برای گذراندن مقدار سرعت استفاده می‌شود.
| Enums |
|---|
PACING_PERIOD_UNSPECIFIED | مقدار دوره در این نسخه مشخص نشده یا ناشناخته است. |
PACING_PERIOD_DAILY | تنظیم ضربان به صورت روزانه اعمال خواهد شد. |
PACING_PERIOD_FLIGHT | تنظیم سرعت در کل مدت پرواز اعمال خواهد شد. |
PacingType
| Enums |
|---|
PACING_TYPE_UNSPECIFIED | مقدار حالت ضربان در این نسخه مشخص نشده یا ناشناخته است. |
PACING_TYPE_AHEAD | فقط برای دوره سرعت PACING_PERIOD_FLIGHT قابل اجرا است. برای اطمینان از اینکه کل بودجه تا پایان پرواز خرج می‌شود، سعی می‌کند سریع‌تر از یکنواخت هزینه کند. |
PACING_TYPE_ASAP | تمام مبلغ بودجه را در سریع ترین زمان ممکن خرج کنید. |
PACING_TYPE_EVEN | در هر دوره زمانی یک مقدار بودجه ثابت خرج کنید. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],["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. |"]]
