BiddingStrategy

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

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
الحقول
الحقل مطلوب. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
fixedBid

object (FixedBidStrategy)

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

object (MaximizeSpendBidStrategy)

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

على مستوى طلب الإدراج، لا يمكن ضبط markupType للبنود الإعلانية على PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM.

بالإضافة إلى ذلك، تحدّد قيمة performanceGoalType المعيّنة لطلب إدراج قيم lineItemType المحتملة المتاحة لبنود إعلانية ضِمن طلب الإدراج هذا:

  • لا تسمح BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA وBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC وBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED إلا بعناصر LINE_ITEM_TYPE_DISPLAY_DEFAULT أو LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • لا يسمح كلّ من BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA وBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN إلا بالبنود الإعلانية LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • لا يسمح BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH إلا بالبنود الإعلانية LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

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

object (YoutubeAndPartnersBiddingStrategy)

استراتيجية عروض أسعار تستخدمها مراجع YouTube والشركاء.

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

object (DemandGenBiddingStrategy)

استراتيجية عروض أسعار تستخدمها حملة زيادة الطلب

لا يمكن استخدامها إلّا مع عنصر أو مجموعة إعلانية في "حملات زيادة الطلب".
نهاية الحقول التي يستبعد كلّ منها الآخر

FixedBidStrategy

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

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

string (int64 format)

مبلغ عرض السعر الثابت بوحدة Micro من عملة المعلِن بالنسبة إلى عنصر طلب الإدراج، يجب ضبط 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 مرات الظهور القابلة للعرض
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH تحقيق أقصى قدر من الوصول.

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)

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

  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA، يكون الحدّ الأقصى هو 10, 000.00 دولار أمريكي.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC، يكون الحدّ الأقصى هو 1000.00 دولار أمريكي.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM، يكون الحدّ الأقصى هو 1000.00 دولار أمريكي.
  • عندما تكون قيمة 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 يتم تحديد قيمة عرض السعر في المجموعة الإعلانية.

DemandGenBiddingStrategy

إعدادات تتحكّم في استراتيجية عروض الأسعار لمراجع "حملات زيادة الطلب"

تمثيل JSON 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
الحقول
type

enum (DemandGenBiddingStrategyType)

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

لا يمكن ضبط هذا الخيار إلا عند تعيينه لبند إعلان. ستكتسب المجموعات الإعلانية هذه القيمة من عنصر حملتها.
value

string (int64 format)

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

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

تكون قيمة هذا الحقل بوحدات ميكرو من عملة المعلِن أو قيمة عائد الإنفاق الإعلاني. على سبيل المثال، يمثّل الرقم 1000000 وحدة واحدة من العملة أو قيمة عائد الإنفاق الإعلاني بنسبة% 100. إذا لم تكن تستخدم استراتيجية قابلة للتطبيق، ستكون قيمة هذا الحقل 0.
effectiveBiddingValue

string (int64 format)

النتائج فقط. القيمة المستخدَمة بفعالية من خلال استراتيجية عروض الأسعار سيكون هذا الحقل هو نفسه value في حال ضبطه. في حال عدم ضبط value وتعيين الاستراتيجية لمجموعة إعلانية، سيتمّ استيراد هذا الحقل من استراتيجية عروض الأسعار الخاصة بـ "السلعة".

إذا لم تكن قيمة type هي DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA أو DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS، ستكون قيمة هذا الحقل 0.
effectiveBiddingValueSource

enum (BiddingSource)

النتائج فقط. مصدر قيمة عرض السعر الفعّال

DemandGenBiddingStrategyType

الأنواع المحتملة لاستراتيجية عروض الأسعار لمراجع "حملات زيادة الطلب"

عمليات التعداد
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED لم يتم تحديد النوع أو أنّه غير معروف.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA استراتيجية عروض أسعار تعمل تلقائيًا على تحسين الإحالات الناجحة لكل دولار.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS استراتيجية عروض أسعار تزيد الإيرادات تلقائيًا إلى أقصى حدّ مع تحقيق متوسط عائد إنفاق إعلاني مستهدَف محدّد.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS استراتيجية عروض أسعار تعمل تلقائيًا على زيادة عدد الإحالات الناجحة إلى أقصى حد
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE استراتيجية عروض أسعار تزيد الأرباح تلقائيًا إلى أقصى حدّ أثناء إنفاق ميزانيتك.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS استراتيجية عروض أسعار تزيد النقرات تلقائيًا إلى أقصى حدّ ضمن ميزانية محدّدة.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC استراتيجية عروض أسعار تعمل على تحسين التكلفة لكل نقرة تلقائيًا.