CampaignBudget

ميزانية الحملة.

تمثيل JSON 
{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لميزانية الحملة. تكون أسماء موارد ميزانية الحملة على النحو التالي:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
status

enum (BudgetStatus)

النتائج فقط. حالة ميزانية هذه الحملة. هذا الحقل للقراءة فقط.
deliveryMethod

enum (BudgetDeliveryMethod)

طريقة العرض التي تحدِّد معدّل إنفاق ميزانية الحملة.

يتم ضبط القيمة تلقائيًا على STANDARD في حال عدم تحديدها في عملية إنشاء.
period

enum (BudgetPeriod)

غير قابل للتغيير. الفترة التي سيتم إنفاق الميزانية خلالها. ويتم ضبط القيمة تلقائيًا على DAILY في حال عدم تحديدها.
type

enum (BudgetType)

غير قابل للتغيير. نوع ميزانية الحملة.
alignedBiddingStrategyId

string (int64 format)

رقم تعريف استراتيجية المحفظة لعروض الأسعار التي تتماشى معها ميزانية الحملة المشتركة. عند توافق استراتيجية عروض أسعار مع ميزانية حملة، يتم إرفاقهما بمجموعة الحملات نفسها. بعد توافق ميزانية الحملة مع استراتيجية عروض أسعار، يجب أن تستخدم الحملات التي تتم إضافتها إلى ميزانية الحملة استراتيجية عروض الأسعار المتوافقة أيضًا.
id

string (int64 format)

النتائج فقط. رقم تعريف ميزانية الحملة.

يتم إنشاء ميزانية الحملة باستخدام عملية إنشاء CampaignBudgetService، ويتم تعيين معرّف ميزانية. يمكن مشاركة رقم تعريف الميزانية على مستوى حملات مختلفة، وستخصّص النظام بعد ذلك ميزانية الحملة بين حملات مختلفة للحصول على أفضل النتائج.
name

string

اسم ميزانية الحملة.

عند إنشاء ميزانية حملة من خلال CampaignBudgetService، يجب أن يكون لكل ميزانية حملة مشتركة بشكل صريح اسمًا غير فارغ أو غير فارغ. إنّ ميزانيات الحملات التي لم تتم مشاركتها بشكلٍ صريح تستمد اسمها من اسم الحملة المرفق.

يجب أن يتراوح طول هذه السلسلة بين 1 و255، بشكل شامل، بترميز UTF-8 بايت (مع اقتطاع).
amountMicros

string (int64 format)

مبلغ الميزانية، بالعملة المحلية للحساب. ويتمّ تحديد المبلغ بالمايكرو، حيث أنّ المليون يعادل وحدة عملة واحدة. ويبلغ الحدّ الأقصى للإنفاق الشهري 30.4 ضِعف هذا المبلغ.
totalAmountMicros

string (int64 format)

مبلغ الميزانية منذ إنشائها، بالعملة المحلية للحساب. ويتمّ تحديد المبلغ بالمايكرو، حيث أنّ المليون يعادل وحدة عملة واحدة.
explicitlyShared

boolean

تحدد ما إذا كانت قد تمت مشاركة الميزانية بشكل صريح أم لا. يتم ضبط هذه السياسة تلقائيًا على "صحيح" إذا لم يتم تحديدها في عملية إنشاء.

في حال تحديد هذا الخيار، تم إنشاء الميزانية بغرض مشاركتها على مستوى حملة واحدة أو أكثر.

في حال اختيار خطأ، هذا يعني أنّه تم إنشاء الميزانية بغرض استخدامها في حملة واحدة فقط. وسيظل اسم الميزانية وحالتها متزامنَين مع اسم الحملة وحالتها. ستؤدي محاولة مشاركة الميزانية مع حملة ثانية إلى حدوث خطأ.

يمكن أن تصبح الميزانية غير المشتركة ميزانية مشتركة بشكلٍ صريح. يجب أن يتم أيضًا تعيين اسم للميزانية من خلال العملية نفسها.

لا يمكن أبدًا أن تصبح ميزانية حملة مشتركة غير مشتركة.
referenceCount

string (int64 format)

النتائج فقط. عدد الحملات التي تستخدم الميزانية بشكلٍ نشط

هذا الحقل للقراءة فقط.
recommendedBudgetAmountMicros

string (int64 format)

النتائج فقط. مبلغ الميزانية المقترَح. في حال عدم توفُّر أي اقتراح، سيتم ضبط هذا الإعداد على مبلغ الميزانية. ويتمّ تحديد المبلغ بالمايكرو، حيث أنّ المليون يعادل وحدة عملة واحدة.

هذا الحقل للقراءة فقط.
recommendedBudgetEstimatedChangeWeeklyClicks

string (int64 format)

النتائج فقط. التغيير المقدر في النقرات الأسبوعية في حال تطبيق الميزانية المقترحة.

هذا الحقل للقراءة فقط.
recommendedBudgetEstimatedChangeWeeklyCostMicros

string (int64 format)

النتائج فقط. التغيير المقدَّر في التكلفة الأسبوعية بالمايكرو في حال تطبيق الميزانية المقترَحة. المليون تساوي وحدة عملة واحدة.

هذا الحقل للقراءة فقط.
recommendedBudgetEstimatedChangeWeeklyInteractions

string (int64 format)

النتائج فقط. التغيير المقدَّر في التفاعلات الأسبوعية في حال تطبيق الميزانية المقترَحة.

هذا الحقل للقراءة فقط.
recommendedBudgetEstimatedChangeWeeklyViews

string (int64 format)

النتائج فقط. التغيير المقدَّر في عدد المشاهدات الأسبوعية في حال تطبيق الميزانية المقترَحة.

هذا الحقل للقراءة فقط.

BudgetStatus

الحالات المحتملة للميزانية.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ENABLED تم تفعيل الميزانية.
REMOVED تمت إزالة الميزانية.

BudgetDeliveryMethod

طرق العرض الممكنة للميزانية.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
STANDARD وسيتحكّم خادم الميزانية في عرض الإعلانات بشكل متساوٍ على مدار الفترة الزمنية بالكامل.
ACCELERATED لن يحدّ خادم الميزانية من عرض الإعلانات، وسيتم عرض الإعلانات في أسرع وقت ممكن.

BudgetPeriod

الفترة المحتملة للميزانية.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
DAILY الميزانية اليومية.
CUSTOM_PERIOD تمت إضافة ميزانية مخصصة مرة أخرى في الإصدار 5. يمكن استخدام الميزانية المخصّصة مع total_amount لتحديد حدّ الميزانية الدائمة. يمكنك الانتقال إلى https://support.google.com/google-ads/answer/6385083 للاطّلاع على مزيد من المعلومات.

BudgetType

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

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
STANDARD نوع الميزانية للاستخدام العادي في "إعلانات Google" يضع حدًا للإنفاق اليومي مضروبًا في مبلغ الميزانية المحدد. التفاصيل الكاملة: https://support.google.com/google-ads/answer/6385083
FIXED_CPA

نوع الميزانية مع تكلفة ثابتة للإجراء. التفاصيل الكاملة: https://support.google.com/google-ads/answer/7528254

لا يتوفّر هذا النوع إلا من خلال الحملات التي تحتوي على AdvertisingChannelType.DISPLAY (باستثناء AdvertisingChannelSubType.DISPLAY_CASE) وBidStrategyType.TARGET_CPA وPaymentMode.روح.
SMART_CAMPAIGN

نوع الميزانية للحملة الذكية التفاصيل الكاملة: https://support.google.com/google-ads/answer/7653509

لا يتوافق هذا النوع إلا مع الحملات التي تحتوي على AdvertisingChannelType.SMART و AdvertisingChannelSubType.SMART_CAMPAIGN.
LOCAL_SERVICES

نوع ميزانية "حملة الخدمات المحلّية" التفاصيل الكاملة: https://support.google.com/localservices/answer/7434558

لا يتوافق هذا النوع إلا مع الحملات التي تحتوي على AdvertisingChannelType.LOCAL_SERVICES.