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

如果分配的自定义出价算法使用的 Floodlight 活动未在 floodlightActivityConfigs 中标识，则系统会返回错误。

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 时，上限为 10, 000.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 美元 CPM（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 时适用。

如果分配的自定义出价算法使用的 Floodlight 活动未在 floodlightActivityConfigs 中标识，则系统会返回错误。

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