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.

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، يكون الحدّ الأقصى هو 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، سيستند عرض السعر إلى احتمالية أن تكون كل مرّة ظهور متاحة قابلة للعرض. على سبيل المثال، إذا كانت التكلفة المستهدَفة لكلّ ألف ظهور قابل للعرض تبلغ دولارَين أمريكيَين (أو ما يعادلهما بالعملة المحلّية) ويُحتمَل أن تكون مرّة الظهور قابلة للعرض بنسبة 40%، سيكون سعر عرض السعر 0.80 دولار أمريكي (أو ما يعادله بالعملة المحلّية) لكلّ ألف ظهور ( 40% من دولارَين أمريكيَين).

على سبيل المثال، يمثّل 1500000 1.5 وحدة عادية من قيمة العملة أو عائد الإنفاق الإعلاني (ROAS).
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.

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