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

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

حقل الاتحاد 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