العرض تم إيقاف الإصدار الثاني من Video 360 API. استخدام الشاشة & الإصدار 3 من Video 360 API بدلاً من ذلك. للحصول على تعليمات حول نقل البيانات من الإصدار 2 إلى الإصدار 3، يُرجى الاطّلاع على دليل نقل البيانات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

BiddingStrategy

تمثيل JSON
FixedBidStrategy
- تمثيل JSON
MaximizeSpendBidStrategy
- تمثيل JSON
BiddingStrategyPerformanceGoalType
PerformanceGoalBidStrategy
- تمثيل JSON

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

تمثيل JSON

تمثيل 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`. }

{

  // 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 وحدة قياسية من العملة.

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 وحدة عادية من العملة أو قيمة عائد الإنفاق الإعلاني.
`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`.