Pacing

هي الإعدادات التي تتحكّم في معدّل إنفاق الميزانية.

تمثيل JSON
{
  "pacingPeriod": enum (PacingPeriod),
  "pacingType": enum (PacingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dailyMaxMicros": string,
  "dailyMaxImpressions": string
  // End of mutually exclusive fields.
}
الحقول
pacingPeriod

enum (PacingPeriod)

الحقل مطلوب. الفترة الزمنية التي سيتم فيها إنفاق الميزانية المحدّدة وفق الوتيرة.

عند تفعيل التخصيص التلقائي للميزانية في طلب الإدراج من خلال automationType، يكون هذا الحقل مخصّصًا للإخراج فقط ويتم ضبطه تلقائيًا على PACING_PERIOD_FLIGHT.

pacingType

enum (PacingType)

الحقل مطلوب. نوع الوتيرة الذي يحدّد كيفية إنفاق مبلغ الميزانية على مستوى pacingPeriod.

لا يتوافق الحقل "PACING_TYPE_ASAP" مع الحقل "pacingPeriod" PACING_PERIOD_FLIGHT لطلبات الإدراج.

تنطبق هذه السمة عندما يتم ضبط السمة pacing_period على PACING_PERIOD_DAILY. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
dailyMaxMicros

string (int64 format)

الحد الأقصى للمبلغ الذي يتم إنفاقه يوميًا بالوحدات الصغرى لعملة المعلِن.

ينطبق ذلك عندما تكون الميزانية مستندة إلى العملة. يجب أن تكون القيمة أكبر من 0. على سبيل المثال، بالنسبة إلى 1.5 وحدة عادية من العملة، اضبط هذا الحقل على 1500000.

سيتم تقريب القيمة المحدّدة إلى وحدات كاملة قابلة للفوترة للعملة ذات الصلة وفقًا للقواعد التالية: سيتم تقريب أي قيمة موجبة أقل من وحدة واحدة قابلة للفوترة إلى وحدة واحدة قابلة للفوترة، وسيتم تقريب أي قيمة أكبر من وحدة واحدة قابلة للفوترة إلى أقرب قيمة قابلة للفوترة. على سبيل المثال، إذا كانت الوحدة القابلة للفوترة للعملة هي 0.01، وتم ضبط هذا الحقل على 10257770، سيتم تقريب القيمة إلى 10250000، أي بقيمة 10.25. وإذا تم ضبطها على 505، سيتم تقريبها إلى 10000، أي بقيمة 0.01.

dailyMaxImpressions

string (int64 format)

الحد الأقصى لعدد مرات الظهور التي يتم عرضها كل يوم.

ينطبق ذلك عندما تكون الميزانية مستندة إلى مرّات الظهور. يجب أن تكون القيمة أكبر من 0.

نهاية الحقول التي يستبعد كلّ منها الآخر

PacingPeriod

الفترات الزمنية المحتملة المستخدَمة للإنفاق حتى الوصول إلى مبلغ الوتيرة

عمليات التعداد
PACING_PERIOD_UNSPECIFIED لم يتم تحديد قيمة الفترة أو أنّها غير معروفة في هذا الإصدار.
PACING_PERIOD_DAILY سيتم تطبيق إعداد وتيرة الإنفاق يوميًا.
PACING_PERIOD_FLIGHT سيتم تطبيق إعدادات وتيرة عرض الإعلانات على مدة العرض بالكامل.

PacingType

أنواع الوتيرة المحتملة

عمليات التعداد
PACING_TYPE_UNSPECIFIED لم يتم تحديد قيمة وضع السرعة أو أنّها غير معروفة في هذا الإصدار.
PACING_TYPE_AHEAD ينطبق ذلك فقط على فترة وتيرة العرض التي تبلغ PACING_PERIOD_FLIGHT. تحاول وتيرة الإنفاق السريعة إنفاق الميزانية بشكل أسرع من وتيرة الإنفاق المتساوية، وذلك لضمان إنفاق الميزانية بالكامل بحلول نهاية فترة عرض الإعلانات.
PACING_TYPE_ASAP إنفاق مبلغ الميزانية المحدّدة بالكامل في أسرع وقت ممكن
PACING_TYPE_EVEN أنفق مبلغًا ثابتًا من الميزانية في كل فترة زمنية.