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)

僅供輸出。要修改出價的條件 ID。

若是變更,系統會忽略此欄位。

bidModifier

number

符合條件時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。PreferredContent 的範圍介於 1.0 至 6.0 之間。如要停用裝置類型,請輸入 0。

baseAdGroup

string

僅供輸出。建立這個草稿/試用廣告群組出價調節係數的基礎廣告群組。如果 adGroup 是基礎廣告群組,則此欄位將等於 adGroup。如果廣告群組是在草稿或實驗組中建立,且沒有對應的基礎廣告群組,這個欄位就會是空值。這是唯讀欄位。

聯集欄位 criterion。此廣告群組出價調節係數的條件。

從第 5 版開始建立作業時需要。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。