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 לתוכן מועדף. יש להשתמש בספרה 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.