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)

مبلغ عرض السعر الثابت، بوحدة الميكرو من عملة المعلِن بالنسبة إلى كيان طلب الترتيب، يجب ضبط 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)

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

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

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 قيمة 1.0 وحدة عادية من العملة أو قيمة عائد إنفاق إعلاني بنسبة% 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 استراتيجية عروض أسعار تعمل على تحسين تكلفة النقرة تلقائيًا.