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. אם קבוצת המודעות נוצרה בטיוטה או לניסיון ואין לה קבוצת מודעות בסיסית תואמת, השדה הזה יהיה 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.