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)

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

המערכת מתעלמת מהשדה הזה בפעולות שינוי (mutate).
bidModifier

number

המכפיל של הצעת המחיר כשהקריטריון תואם. ערך הצירוף חייב להיות בטווח: 0.1 עד 10.0. הטווח הוא בין 1.0 ל-6.0 לתוכן מועדף. כדי לבטל את ההסכמה להפעלת סוג מכשיר מסוים, צריך להשתמש בספרה 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

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

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