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)
  }
  // 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)

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

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

YouTube 和合作夥伴資源使用的出價策略。只能用於 YouTube 與合作夥伴委刊項或廣告群組實體。

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 都有上限:

  • 如果 performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA,上限為 10000.00 美元。
  • 如果 performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC,上限為 1000.00 美元。
  • 如果 performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM,上限為 1000.00 美元。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO 時,上限為 1000.00,下限則為 0.01。

範例:如果設為 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM,系統會根據每次可用曝光的可視機率來設定出價。舉例來說,假設千次可視曝光出價目標為 NT$60 元,且某次曝光的可視機率為 40%,則出價為 NT$24 元 (千次曝光出價的 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 時才能使用。

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 出價值是在廣告群組中定義。