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 之間。PreferredContent 的範圍為 1.0 到 6.0。輸入 0 即可停用特定裝置類型。

baseAdGroup

string

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

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

自 V5 起,在建立作業中為必填項目。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 格式顯示的結束日期。