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)

必需。出价策略将尝试达到或超越的效果目标,以广告客户所用币种的微单位或广告支出回报率 (ROAS) 价值的微单位(取决于广告客户的币种)。必须大于或等于给定货币的可结算单位,且小于或等于上限。每个 performanceGoalType 都有其上限:

  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA 时,上限为 10000.00 USD。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 时,上限为 1000.00 USD。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 时,上限为 1000.00 USD。
  • performanceGoalTypeBIDDING_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 个标准单位的货币或 ROAS。

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 时适用。