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 للمحتوى Preferred. استخدِم 0 لإيقاف نوع جهاز.
baseAdGroup

string

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

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

مطلوب في عمليات الإنشاء التي تبدأ بـ V5. يمكن أن تكون السمة "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.