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

פלט בלבד. קבוצת המודעות הבסיסית שממנה נוצר שינוי הצעת המחיר לטיוטה/לניסוי של קבוצת המודעות. אם קבוצת המודעות היא קבוצת מודעות בסיסית, השדה הזה יהיה שווה לקבוצת המודעות. אם קבוצת המודעות נוצרה בטיוטה או בניסוי ואין לה קבוצת מודעות בסיסית תואמת, השדה הזה יהיה null. שדה זה הוא לקריאה בלבד.

שדה איחוד criterion. הקריטריון של התאמת הצעת המחיר לקבוצת מודעות זו.

נדרש בפעולות יצירה שמתחילות ב-V5. criterion יכול להיות רק אחד מהבאים:
hotelDateSelectionType

object (HotelDateSelectionTypeInfo)

בלתי משתנה. קריטריון לבחירת תאריך של מלון (תאריכי ברירת המחדל לעומת בחירת המשתמש).
hotelAdvanceBookingWindow

object (HotelAdvanceBookingWindowInfo)

בלתי משתנה. הקריטריון למספר הימים לפני השהייה מתבצעת ההזמנה.
hotelLengthOfStay

object (HotelLengthOfStayInfo)

בלתי משתנה. קריטריון למשך השהייה במלון בלילות.
hotelCheckInDay

object (HotelCheckInDayInfo)

בלתי משתנה. הקריטריון ליום בשבוע שבו ההזמנה בוצעה.
device

object (DeviceInfo)

בלתי משתנה. קריטריון של מכשיר.
hotelCheckInDateRange

object (HotelCheckInDateRangeInfo)

בלתי משתנה. קריטריון לטווח תאריכים של צ'ק-אין במלון.

BidModifierSource

ספירה שמתארת את המקורות האפשריים להתאמת הצעת המחיר.

טיפוסים בני מנייה (enums)
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.