AdGroupBidModifier

يمثل معدِّل عروض أسعار على مستوى المجموعة الإعلانية.

تمثيل JSON 
{
  "resourceName": string,
  "bidModifierSource": enum (BidModifierSource),
  "adGroup": string,
  "criterionId": string,
  "bidModifier": number,
  "baseAdGroup": string,

  // Union field criterion can be only one of the following:
  "hotelDateSelectionType": {
    object (HotelDateSelectionTypeInfo)
  },
  "hotelAdvanceBookingWindow": {
    object (HotelAdvanceBookingWindowInfo)
  },
  "hotelLengthOfStay": {
    object (HotelLengthOfStayInfo)
  },
  "hotelCheckInDay": {
    object (HotelCheckInDayInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "hotelCheckInDateRange": {
    object (HotelCheckInDateRangeInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لمعدِّل عروض أسعار المجموعة الإعلانية. وتكون أسماء موارد معدِّلات عروض أسعار المجموعة الإعلانية على النحو التالي:

customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId}
bidModifierSource

enum (BidModifierSource)

النتائج فقط. مصدر معدِّل عروض الأسعار.
adGroup

string

غير قابل للتغيير. المجموعة الإعلانية التي ينتمي إليها هذا المعيار.
criterionId

string (int64 format)

النتائج فقط. رقم تعريف المعيار المطلوب تعديل عرض السعر له.

يتم تجاهل هذا الحقل لعمليات التغيير.
bidModifier

number

معدِّل عرض السعر عند تطابق المعيار. يجب أن يكون المُعدَّل في النطاق: 0.1 - 10.0. يتراوح النطاق بين 1.0 و6.0 لـ PreferredContent. استخدِم 0 لإيقاف نوع الجهاز.
baseAdGroup

string

النتائج فقط. المجموعة الإعلانية الأساسية التي تم إنشاء معدِّل عروض أسعار المجموعة الإعلانية الاختبارية/للمجموعة الإعلانية التجريبية منها. إذا كانت المجموعة الإعلانية هي مجموعة إعلانية أساسية، سيكون هذا الحقل مساويًا للمجموعة الإعلانية. إذا تم إنشاء المجموعة الإعلانية في حالة مسودّة أو تجربة ولا تحتوي على مجموعة إعلانية أساسية مقابلة، سيكون هذا الحقل فارغًا. هذا الحقل للقراءة فقط.

حقل الاتحاد criterion. معيار معدِّل عروض أسعار المجموعة الإعلانية هذا.

مطلوب في عمليات الإنشاء التي تبدأ من الإصدار 5. يمكن أن يكون criterion واحدًا فقط مما يلي:
hotelDateSelectionType

object (HotelDateSelectionTypeInfo)

غير قابل للتغيير. معيار اختيار تاريخ الفندق (التواريخ التلقائية في مقابل اختيار المستخدم)
hotelAdvanceBookingWindow

object (HotelAdvanceBookingWindowInfo)

غير قابل للتغيير. هو المعيار لعدد الأيام التي تسبق الإقامة التي يتم إجراء الحجز بها.
hotelLengthOfStay

object (HotelLengthOfStayInfo)

غير قابل للتغيير. معيار مدة الإقامة في الفندق بالليل.
hotelCheckInDay

object (HotelCheckInDayInfo)

غير قابل للتغيير. معيار اليوم من الأسبوع الذي يتم الحجز فيه.
device

object (DeviceInfo)

غير قابل للتغيير. معيار الجهاز
hotelCheckInDateRange

object (HotelCheckInDateRangeInfo)

غير قابل للتغيير. معيار النطاق الزمني لتسجيل الوصول إلى الفندق.

BidModifierSource

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم لأغراض القيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
CAMPAIGN يتم تحديد معدِّل عروض الأسعار على مستوى الحملة، في المعيار على مستوى الحملة.
AD_GROUP يتم تحديد معدِّل عروض الأسعار (تم تجاوزه) على مستوى المجموعة الإعلانية.

HotelDateSelectionTypeInfo

معيار اختيار تاريخ الفندق (التواريخ التلقائية في مقابل اختيار المستخدم)

تمثيل JSON 
{
  "type": enum (HotelDateSelectionType)
}
الحقول
type

enum (HotelDateSelectionType)

نوع اختيار تاريخ الفندق

HotelAdvanceBookingWindowInfo

هو المعيار لعدد الأيام التي تسبق الإقامة التي يتم إجراء الحجز بها.

تمثيل JSON 
{
  "minDays": string,
  "maxDays": string
}
الحقول
minDays

string (int64 format)

نهاية منخفضة لعدد الأيام التي تسبق الإقامة.
maxDays

string (int64 format)

تمثّل هذه السمة نهاية عالية لعدد الأيام التي تسبق الإقامة.

HotelLengthOfStayInfo

معيار مدة الإقامة في الفندق بالليل.

تمثيل JSON 
{
  "minNights": string,
  "maxNights": string
}
الحقول
minNights

string (int64 format)

قيمة منخفضة لعدد ليالي الإقامة.
maxNights

string (int64 format)

تمثّل هذه السمة نهاية عالية لعدد ليالي الإقامة.

HotelCheckInDayInfo

معيار اليوم من الأسبوع الذي يتم الحجز فيه.

تمثيل JSON 
{
  "dayOfWeek": enum (DayOfWeek)
}
الحقول
dayOfWeek

enum (DayOfWeek)

اليوم من الأسبوع.

HotelCheckInDateRangeInfo

معيار النطاق الزمني لتسجيل الوصول.

تمثيل JSON 
{
  "startDate": string,
  "endDate": string
}
الحقول
startDate

string

تاريخ البدء بتنسيق YYYY-MM-DD
endDate

string

تاريخ الانتهاء بتنسيق YYYY-MM-DD