BiddingStrategy

الإعدادات التي تتحكّم في استراتيجية عروض الأسعار تحدّد استراتيجية عروض الأسعار سعر العرض.

تمثيل JSON
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
الحقول
حقل الدمج bid_strategy_scheme مطلوب. يمكن أن تكون bid_strategy_scheme إحدى القيم التالية فقط:
fixedBid

object (FixedBidStrategy)

استراتيجية تستخدم سعر عرض أسعار ثابتًا.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

استراتيجية تعدّل عرض السعر تلقائيًا لتحسين الأداء وفقًا لهدفك مع إنفاق الميزانية الكاملة.

على مستوى طلب الإدراج، لا يمكن ضبط markupType للعناصر على PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. بالإضافة إلى ذلك، عندما تكون قيمة performanceGoalType إحدى القيم التالية:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

يجب أن يكون lineItemType لعناصر طلب الإدراج أحد الخيارَين التاليَين:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

وعندما تكون قيمة performanceGoalType إحدى القيمتين التاليتين:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

يجب أن تكون lineItemType عناصر طلب الإدراج LINE_ITEM_TYPE_VIDEO_DEFAULT.

performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

استراتيجية تعدّل عرض السعر تلقائيًا لتحقيق هدف أداء محدّد أو تجاوزه. يجب استخدامها فقط لكيان عنصر حملة.

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

استراتيجية عروض أسعار تستخدمها "موارد YouTube ومنصات الشركاء". يمكن استخدامها فقط مع تفاصيل الإعلان أو المجموعة الإعلانية على YouTube والشركاء.

FixedBidStrategy

استراتيجية تستخدم سعر عرض أسعار ثابتًا.

تمثيل JSON
{
  "bidAmountMicros": string
}
الحقول
bidAmountMicros

string (int64 format)

مبلغ عرض السعر الثابت، بوحدات المايكرو من عملة المعلِن بالنسبة إلى عنصر طلب الإدراج، يجب ضبط bidAmountMicros على 0. بالنسبة إلى عنصر السعر، يجب أن تكون قيمة bidAmountMicros أكبر من أو تساوي وحدة الفوترة للعملة المحدّدة وأقل من أو تساوي الحدّ الأقصى 1000000000.

على سبيل المثال، يمثّل الرقم 1500000 مقدار 1.5 وحدة عادية من العملة.

MaximizeSpendBidStrategy

استراتيجية تعدّل عرض السعر تلقائيًا لتحسين هدف أداء محدّد مع إنفاق الميزانية الكاملة

تمثيل JSON
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
الحقول
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

مطلوب. نوع هدف الأداء الذي تحاول استراتيجية عروض الأسعار تقليله إلى الحدّ الأدنى أثناء إنفاق الميزانية بالكامل لا يمكن استخدام سمة BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM مع هذه الاستراتيجية.

maxAverageCpmBidAmountMicros

string (int64 format)

الحدّ الأقصى لمتوسط التكلفة لكل ألف ظهور الذي يمكن عرضه، بوحدات ميكرو من عملة المعلِن. يجب أن تكون القيمة أكبر من أو تساوي وحدة قابلة للفوترة من العملة المحدّدة.

على سبيل المثال، يمثّل الرقم 1500000 مقدار 1.5 وحدة عادية من العملة.

raiseBidForDeals

boolean

تُستخدَم لتحديد ما إذا كانت الاستراتيجية تأخذ الأسعار الدنيا للصفقات في الاعتبار.

customBiddingAlgorithmId

string (int64 format)

معرّف خوارزمية عروض الأسعار المخصّصة المستخدَمة في هذه الاستراتيجية. لا ينطبق هذا الخيار إلا عندما يكون performanceGoalType مضبوطًا على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

سيؤدي تعيين خوارزمية عروض أسعار مخصّصة تستخدم أنشطة Floodlight لم يتم تحديدها في floodlightActivityConfigs إلى ظهور خطأ.

BiddingStrategyPerformanceGoalType

الأنواع المحتملة لهدف الأداء لاستراتيجية عروض الأسعار.

عمليات التعداد
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA تكلفة الإجراء
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC تكلفة النقرة
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM التكلفة لكل ألف ظهور قابل للعرض
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO خوارزمية عروض الأسعار المخصّصة
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA المشاهدات المكتملة بصيغة مسموعة
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN مشاهدات وقت المشاهدة لأكثر من 10 ثوانٍ
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED مرات الظهور القابلة للعرض

PerformanceGoalBidStrategy

استراتيجية تعدّل عرض السعر تلقائيًا لتحقيق هدف أداء محدّد أو تجاوزه.

تمثيل JSON
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
الحقول
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

مطلوب. نوع هدف الأداء الذي ستحاول استراتيجية عروض الأسعار تحقيقه أو تجاوزه.

بالنسبة إلى استخدام على مستوى عنصر الحملة، يجب أن تكون القيمة إحدى القيم التالية:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

مطلوب. هدف الأداء الذي ستحاول استراتيجية عروض الأسعار تحقيقه أو تجاوزه، وذلك بوحدات ميكرو من عملة المعلِن أو بوحدات ميكرو من قيمة عائد الإنفاق الإعلاني (ROAS) المستندة أيضًا إلى عملة المعلِن. يجب أن تكون القيمة أكبر من أو تساوي وحدة قابلة للفوترة من العملة المحدّدة وأصغر من أو تساوي الحدود العليا. لكل performanceGoalType حدّ أعلى:

  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA، يكون الحدّ الأقصى هو 10000.00 دولار أمريكي.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC، يكون الحدّ الأقصى 1000.00 SAR.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM، يكون الحدّ الأقصى 1000.00 SAR.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO، يكون الحدّ الأعلى هو 1000.00 والحدّ الأدنى هو 0.01.

مثال: إذا تم ضبطها على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM، سيستند سعر عرض السعر إلى احتمال أن يكون كل مرّة ظهور متاحة قابلة للعرض. على سبيل المثال، إذا كانت التكلفة المستهدَفة لكلّ ألف ظهور قابل للعرض هي 2 دولار أمريكي، وكان من المرجّح أن تكون إحدى مرّات الظهور قابلة للعرض بنسبة% 40، سيكون سعر عرض السعر هو 0.80 دولار أمريكي لكلّ ألف ظهور (‎40% من 2 دولار أمريكي).

على سبيل المثال، يمثّل الرقم 1500000 مقدار 1.5 وحدة عادية من قيمة العملة أو عائد النفقات الإعلانية.

maxAverageCpmBidAmountMicros

string (int64 format)

الحدّ الأقصى لمتوسط التكلفة لكل ألف ظهور الذي يمكن عرضه، بوحدات ميكرو من عملة المعلِن. يجب أن تكون القيمة أكبر من أو تساوي وحدة قابلة للفوترة من العملة المحدّدة. لا ينطبق ذلك عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

على سبيل المثال، يمثّل الرقم 1500000 مقدار 1.5 وحدة عادية من العملة.

customBiddingAlgorithmId

string (int64 format)

معرّف خوارزمية عروض الأسعار المخصّصة المستخدَمة في هذه الاستراتيجية. لا ينطبق هذا الخيار إلا عندما يكون performanceGoalType مضبوطًا على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

سيؤدي تعيين خوارزمية عروض أسعار مخصّصة تستخدم أنشطة Floodlight لم يتم تحديدها في floodlightActivityConfigs إلى ظهور خطأ.

YoutubeAndPartnersBiddingStrategy

إعدادات تتحكّم في استراتيجية عروض الأسعار لمصادر YouTube والشركاء

تمثيل JSON
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
الحقول
type

enum (YoutubeAndPartnersBiddingStrategyType)

نوع استراتيجية عروض الأسعار.

value

string (int64 format)

القيمة التي تستخدمها استراتيجية عروض الأسعار

عند تعيين استراتيجية عروض الأسعار على مستوى عنصر الحملة، لا ينطبق هذا الحقل إلا على أنواع الاستراتيجيات التالية:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

عندما يتم تحديد استراتيجية عروض الأسعار على مستوى المجموعة الإعلانية، لا ينطبق هذا الحقل إلا على أنواع الاستراتيجيات التالية:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

إذا لم يتم استخدام استراتيجية قابلة للتطبيق، ستكون قيمة هذا الحقل 0.

adGroupEffectiveTargetCpaValue

string (int64 format)

النتائج فقط. التكلفة المستهدَفة الفعّالة للإجراء على مستوى المجموعة الإعلانية، بوحدات ميكرو من عملة المعلِن

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

النتائج فقط. مصدر قيمة التكلفة المستهدَفة الفعّالة للإجراء على مستوى المجموعة الإعلانية

YoutubeAndPartnersBiddingStrategyType

أنواع استراتيجيات عروض الأسعار المحتملة لموارد YouTube والشركاء

عمليات التعداد
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED لم يتم تحديد النوع أو أنّه غير معروف.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV استراتيجية عروض أسعار تدفع مبلغًا قابلاً للتعديل مقابل كل مشاهدة فيديو.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM استراتيجية عروض أسعار تدفع مبلغًا قابلاً للضبط لكلّ مرّة ظهور.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA استراتيجية عروض أسعار تعمل تلقائيًا على تحسين الإحالات الناجحة لكل دولار أمريكي.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM استراتيجية عروض أسعار تدفع مبلغًا قابلاً للضبط لكلّ مرّة ظهور.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM استراتيجية عروض أسعار لعناصر "الحجز الفوري" على YouTube تدفع مبلغًا ثابتًا لكلّ مرّة ظهور.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT استراتيجية عروض أسعار مبرمَجة تحدِّد عروض الأسعار لتحقيق الحدّ الأقصى من التحسّن.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS استراتيجية عروض أسعار تزيد تلقائيًا من عدد الإحالات الناجحة في حدود ميزانية يومية.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV استراتيجية عروض أسعار تعمل تلقائيًا على تحسين التكلفة لكلّ مشاهدة فيديو.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS استراتيجية عروض أسعار تزيد الأرباح تلقائيًا إلى أقصى حدّ مع تحقيق متوسّط عائد إنفاق إعلاني مستهدَف محدّد.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE استراتيجية عروض أسعار تحدّد عروض الأسعار تلقائيًا لزيادة الأرباح إلى أقصى حدّ مع إنفاق ميزانيتك.

BiddingSource

مصدر قيمة عروض الأسعار

عمليات التعداد
BIDDING_SOURCE_UNSPECIFIED لم يتم تحديد مصدر عروض الأسعار أو أنّه غير معروف.
BIDDING_SOURCE_LINE_ITEM يتم اكتساب قيمة عروض الأسعار من عنصر الحملة.
BIDDING_SOURCE_AD_GROUP يتم تحديد قيمة عروض الأسعار في المجموعة الإعلانية.