BiddingStrategy

JSON 表示法
FixedBidStrategy <ph type="x-smartling-placeholder">
- JSON 表示法
MaximizeSpendBidStrategy <ph type="x-smartling-placeholder">
- JSON 表示法
BiddingStrategyPerformanceGoalType
PerformanceGoalBidStrategy <ph type="x-smartling-placeholder">
- JSON 表示法
YoutubeAndPartnersBiddingStrategy <ph type="x-smartling-placeholder">
- JSON 表示法
YoutubeAndPartnersBiddingStrategyType
BiddingSource

用于控制出价策略的设置。出价由出价策略决定。

JSON 表示法

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`. }

{

  // 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 个标准货币单位。

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`	出价值在广告组中定义。