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)

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

如果是 muts,系統會忽略這個欄位。

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 格式顯示的結束日期。