BiddingStrategy

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

تمثيل JSON 
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // 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)

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

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، يكون الحد الأقصى هو 10000.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% من 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.