BiddingStrategy

控制出價策略的設定。出價策略會決定出價金額。

JSON 表示法 
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
欄位
聯集欄位 bid_strategy_scheme。必填。bid_strategy_scheme 只能是下列其中一項：
fixedBid

object (FixedBidStrategy)

採用固定出價的策略。
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

這項策略會自動調整出價，盡量達成成效目標，同時用盡預算。

在廣告訂單層級，委刊項的 markupType 無法設為 PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM。

此外，指派給廣告訂單的 performanceGoalType 值會決定該廣告訂單下委刊項可用的 lineItemType 值：

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 和 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED 只允許 LINE_ITEM_TYPE_DISPLAY_DEFAULT 或 LINE_ITEM_TYPE_VIDEO_DEFAULT 委刊項。
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA 和 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 僅允許 LINE_ITEM_TYPE_VIDEO_DEFAULT 委刊項。
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH 僅允許 LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP 委刊項。
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

這項策略會自動調整出價，以達到或超越指定的成效目標。只能用於委刊項實體。
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

YouTube 和合作夥伴資源使用的出價策略。

只能用於 YouTube 和合作夥伴委刊項或廣告群組實體。
demandGenBid

object (DemandGenBiddingStrategy)

需求開發資源使用的出價策略。

只能用於需求開發委刊項或廣告群組實體。

FixedBidStrategy

採用固定出價的策略。

JSON 表示法 
{
  "bidAmountMicros": string
}
欄位
bidAmountMicros

string (int64 format)

固定出價金額，以廣告主幣別的百萬分之一為單位。如果是廣告訂單實體，bidAmountMicros 應設為 0。如果是行項目實體，bidAmountMicros 必須大於或等於指定貨幣的可計費單位，且小於或等於上限 1000000000。

舉例來說，1500000 代表 1.5 個標準貨幣單位。

MaximizeSpendBidStrategy

這項策略會自動調整出價，盡量達成指定的成效目標，同時用盡預算。

JSON 表示法 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
欄位
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

必填。出價策略在支出全部預算時，會盡量減少的成效目標類型。這項策略不支援「BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM」。
maxAverageCpmBidAmountMicros

string (int64 format)

以廣告主幣別的微元為單位，表示可出價的最高平均千次曝光出價。必須大於或等於指定幣別的計費單位。

舉例來說，1500000 代表 1.5 個標準貨幣單位。
raiseBidForDeals

boolean

策略是否會考量交易底價。
customBiddingAlgorithmId

string (int64 format)

這項策略使用的自訂出價演算法 ID。只有在 performanceGoalType 設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 時才適用。

如果指派的自訂出價演算法使用 floodlightActivityConfigs 中未識別的 Floodlight 活動，系統會傳回錯誤。

BiddingStrategyPerformanceGoalType

出價策略的可能成效目標類型。

列舉
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED 這個版本未指定或不明類型值。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA 單次動作出價。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 單次點擊出價。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 千次可視曝光出價。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 自訂出價演算法。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA 完整播放影片與音訊的觀看次數。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 觀看時間超過 10 秒的觀看次數。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED 可視曝光次數。
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH 盡量增加觸及。

PerformanceGoalBidStrategy

這項策略會自動調整出價，以達到或超越指定的成效目標。

JSON 表示法 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
欄位
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

必填。出價策略會嘗試達成或超越的成效目標類型。

如要在委刊項層級使用，值必須是下列其中一個：

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO。
performanceGoalAmountMicros

string (int64 format)

必填。出價策略嘗試達成或超越的成效目標，以廣告主幣別的微量單位或廣告投資報酬率 (ROAS) 值的微量單位表示，後者也以廣告主幣別為準。必須大於或等於指定幣別的計費單位，且小於或等於上限。每個 performanceGoalType 都有上限：

  • performanceGoalType 為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA 時，上限為 10000.00 美元。
  • 當 performanceGoalType 為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 時，上限為 1000.00 美元。
  • 當 performanceGoalType 為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 時，上限為 1000.00 美元。
  • 當 performanceGoalType 為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 時，上限為 1000.00，下限為 0.01。

範例：如果設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM，出價會根據每個可用曝光的可視機率而定。舉例來說，假設千次可視曝光出價目標為 $2 美元，且每次曝光的可視機率為 40%，則出價會調整為千次曝光出價 $0.80 美元 (也就是 $2 美元的 40%)。

舉例來說，1500000 代表 1.5 個標準單位的貨幣或廣告投資報酬率值。
maxAverageCpmBidAmountMicros

string (int64 format)

以廣告主幣別的微元為單位，表示可出價的最高平均千次曝光出價。不得小於指定幣別的計費單位。如果 performanceGoalType 設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM，則不適用。

舉例來說，1500000 代表 1.5 個標準貨幣單位。
customBiddingAlgorithmId

string (int64 format)

這項策略使用的自訂出價演算法 ID。只有在 performanceGoalType 設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 時才適用。

如果指派的自訂出價演算法使用 floodlightActivityConfigs 中未識別的 Floodlight 活動，系統會傳回錯誤。

YoutubeAndPartnersBiddingStrategy

控制 YouTube 和合作夥伴資源出價策略的設定。

JSON 表示法 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
欄位
type

enum (YoutubeAndPartnersBiddingStrategyType)

出價策略類型。
value

string (int64 format)

出價策略使用的值。

在委刊項層級指派出價策略時，這個欄位僅適用於下列策略類型：

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

在廣告群組層級指派出價策略時，這個欄位僅適用於下列策略類型：

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

如果未使用適用的策略，這個欄位的值會是 0。
adGroupEffectiveTargetCpaValue

string (int64 format)

僅供輸出。廣告群組的有效目標單次動作出價，以廣告主幣別的微量單位表示。
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

僅供輸出。廣告群組有效目標單次動作出價值的來源。

YoutubeAndPartnersBiddingStrategyType

YouTube 和合作夥伴資源可用的出價策略類型。

列舉
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED 未指定或不明類型。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV 這項出價策略會針對每次影片觀看次數支付可設定的金額。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM 這項出價策略會為每次曝光支付可設定的金額。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA 這種出價策略會自動調整出價，盡量爭取轉換，並提高每塊錢的轉換次數。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM 這項出價策略會為每次曝光支付可設定的金額。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM YouTube 即時預訂委刊項的出價策略，每次曝光會支付固定金額。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT 這是一種自動出價策略，會設定出價，盡量爭取最高升幅。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS 這項出價策略會根據每日預算，自動盡量爭取最多轉換。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV 自動調整單次影片觀看次數出價的策略。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS 這種出價策略會自動盡量提高收益，同時平均達到指定的目標廣告投資報酬率。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 這項出價策略會自動設定出價，在預算內盡量爭取最高收益。

BiddingSource

出價值的來源。

列舉
BIDDING_SOURCE_UNSPECIFIED 未指定或不明的出價來源。
BIDDING_SOURCE_LINE_ITEM 出價會沿用委刊項的值。
BIDDING_SOURCE_AD_GROUP 出價價值是在廣告群組中定義。

DemandGenBiddingStrategy

控制需求開發資源出價策略的設定。

JSON 表示法 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
欄位
type

enum (DemandGenBiddingStrategyType)

(選用步驟) 出價策略類型。

只有在指派給委刊項時，才能設定這個值。廣告群組會沿用委刊項的這項值。
value

string (int64 format)

(選用步驟) 出價策略使用的價值。指派給委刊項或廣告群組時，即可設定這項功能。這個欄位僅適用於下列策略類型：

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

這個欄位的值會以廣告主貨幣的百萬分之一為單位，或是廣告投資報酬率值。舉例來說，1000000 代表 1.0 個標準貨幣單位，或 100% 的廣告投資報酬率值。如果未使用適用的策略，這個欄位的值會是 0。
effectiveBiddingValue

string (int64 format)

僅供輸出。出價策略有效使用的價值。如果已設定，這個欄位會與 value 相同。如果未設定 value，且策略已指派給廣告群組，系統會從委刊項的出價策略沿用這個欄位。

如果 type 不是 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 或 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS，這個欄位的值會是 0。
effectiveBiddingValueSource

enum (BiddingSource)

僅供輸出。有效出價值的來源。

DemandGenBiddingStrategyType

需求開發資源可用的出價策略類型。

列舉
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED 未指定或不明類型。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 這種出價策略會自動調整出價，盡量爭取轉換，並提高每塊錢的轉換次數。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS 這種出價策略會自動盡量提高收益，同時平均達到指定的目標廣告投資報酬率。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS 自動盡量爭取轉換次數的出價策略
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 這項出價策略會自動在預算範圍內盡量爭取收益。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS 這是一種出價策略，可自動在指定預算內盡量爭取最多點擊。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC 這是一種出價策略，可自動調整單次點擊出價。