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)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // 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 المعيّنة لطلب الإدراج قيم 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، يكون الحدّ الأقصى هو 10000.00 دولار أمريكي.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC، يكون الحدّ الأقصى 1000.00 SAR.
  • عندما تكون قيمة performanceGoalType هي BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM، يكون الحدّ الأقصى 1000.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 وحدة واحدة من العملة أو قيمة عائد النفقات الإعلانية بنسبة% 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 استراتيجية عروض أسعار تعمل تلقائيًا على تحسين التكلفة لكل نقرة.