BiddingStrategy

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

JSON 表示法 
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // 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 為下列任一值時：

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED、

廣告訂單委刊項的lineItemType必須符合下列條件：

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT、

當 performanceGoalType 為以下任一項時：

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

廣告訂單委刊項的lineItemType必須是LINE_ITEM_TYPE_VIDEO_DEFAULT。
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

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

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 時才能使用。

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 可視曝光。

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)

必要欄位。出價策略會嘗試以廣告客戶貨幣的百萬分之一或廣告投資報酬率，以廣告客戶的貨幣為準，達成或超越的成效目標。必須大於或等於指定貨幣的可計費單位，並小於或等於上限。每個 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 時才能使用。