يجب أن يوضّح كل عنصر جديد في "عناصر الحملة" ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف نهائيًا لمزيد من التفاصيل.
{"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.}
مطلوب. الفترة الزمنية التي سيتم خلالها إنفاق ميزانية تحديد وتيرة الإنفاق.
عند تفعيل التخصيص التلقائي للميزانية على مستوى أمر الإدراج من خلال automationType، يكون هذا الحقل مخصّصًا للإخراج فقط ويتم ضبطه تلقائيًا على PACING_PERIOD_FLIGHT.
الحدّ الأقصى لمبلغ العملة الذي يمكن إنفاقه كل يوم بالمايكرو من عملة المعلِن
ينطبق ذلك عندما تكون الميزانية مستندة إلى العملة. يجب أن تكون القيمة أكبر من 0. على سبيل المثال، بالنسبة إلى 1.5 وحدة عملة عادية، اضبط هذا الحقل على 1500000.
سيتم تقريب القيمة المحدّدة إلى وحدات قابلة للفوترة كاملة للعملة ذات الصلة وفقًا للقواعد التالية: سيتم تقريب أي قيمة موجبة أقل من وحدة قابلة للفوترة واحدة إلى وحدة قابلة للفوترة واحدة، وسيتم تقريب أي قيمة أكبر من وحدة قابلة للفوترة واحدة إلى أقرب قيمة قابلة للفوترة. على سبيل المثال، إذا كانت وحدة الفوترة للعملة هي 0.01، وتم ضبط هذا الحقل على 10257770، سيتم التقريب إلى 10250000، أي قيمة 10.25. إذا تم ضبطها على 505، سيتم التقريب إلى 10000، أي قيمة 0.01.
الحدّ الأقصى لعدد مرّات الظهور التي يجب عرضها كل يوم
ينطبق ذلك عندما تكون الميزانية مستندة إلى مرات الظهور. يجب أن تكون القيمة أكبر من 0.
PacingPeriod
الفترات الزمنية المحتملة المستخدَمة لإنفاق مبلغ تحديد وتيرة الإنفاق
عمليات التعداد
PACING_PERIOD_UNSPECIFIED
لم يتم تحديد قيمة الفترة أو أنّها غير معروفة في هذا الإصدار.
PACING_PERIOD_DAILY
سيتم تطبيق إعداد وتيرة الإنفاق على أساس يومي.
PACING_PERIOD_FLIGHT
سيتم تطبيق إعداد وتيرة العرض على مدة عرض الإعلان بالكامل.
PacingType
أنواع وتيرة الإنفاق المحتملة
عمليات التعداد
PACING_TYPE_UNSPECIFIED
لم يتم تحديد قيمة وضع تحديد وتيرة العرض أو أنّها غير معروفة في هذا الإصدار.
PACING_TYPE_AHEAD
ينطبق ذلك على فترة تحديد وتيرة عرض PACING_PERIOD_FLIGHT فقط. تحاول وتيرة الإنفاق السريع إنفاق الميزانية بشكل أسرع من الإنفاق بالتساوي، وذلك للتأكّد من إنفاق الميزانية بالكامل بحلول نهاية فترة عرض الإعلانات.
PACING_TYPE_ASAP
إنفاق كل مبلغ ميزانية تحديد وتيرة الإنفاق بأسرع ما يمكن
تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ePacing settings manage the rate at which a budget is spent, either daily or over the entire campaign duration.\u003c/p\u003e\n"],["\u003cp\u003eYou can control spending by setting daily limits for currency or impressions.\u003c/p\u003e\n"],["\u003cp\u003ePacing types allow you to spend evenly, quickly ("ASAP"), or ahead of schedule to exhaust the budget by the campaign's end.\u003c/p\u003e\n"],["\u003cp\u003eStarting November 5, 2024, the "ASAP" pacing type will no longer work with campaign-duration pacing for insertion orders.\u003c/p\u003e\n"]]],["Pacing settings control budget spending rates, defined by `pacingPeriod` and `pacingType`. `pacingPeriod` specifies the time frame (daily or flight duration), with `PACING_PERIOD_FLIGHT` as the default for automated budget allocation. `pacingType` dictates spending behavior (ASAP, ahead, or evenly), with `PACING_TYPE_ASAP` being incompatible with `PACING_PERIOD_FLIGHT`. For daily pacing, `dailyMaxMicros` sets the maximum daily currency spending, and `dailyMaxImpressions` sets the maximum number of daily impressions.\n"],null,["| Display \\& Video 360 API v3 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- [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/v3/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v3/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/v3/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/v3/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/v3/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v3/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v3/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/v3/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 Possible 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 Possible 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. |"]]
