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 معيار معدِّل عروض أسعار المجموعة الإعلانية هذا.

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