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)

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

  • 当 performanceGoalType 为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA 时，上限为 10000.00 USD。
  • 当 performanceGoalType 为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC 时，上限为 1000.00 USD。
  • 当 performanceGoalType 为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM 时，上限为 1000.00 USD。
  • 当 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 个标准单位的货币或 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 时适用。

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 一种出价策略，可在实现平均目标广告支出回报率 (ROAS) 时自动最大限度提高收入。
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 一种出价策略，可在您的预算范围内自动设置出价，以最大限度地提高收入。

BiddingSource

出价值的来源。

枚举
BIDDING_SOURCE_UNSPECIFIED 出价来源未指定或未知。
BIDDING_SOURCE_LINE_ITEM 出价值继承自订单项。
BIDDING_SOURCE_AD_GROUP 出价值在广告组中定义。