BiddingStrategy

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

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
字段
必需。以下是互斥字段的列表。在响应中，最多只能设置其中一个字段：
fixedBid

object (FixedBidStrategy)

使用固定出价的出价策略。
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

一种在用尽预算的同时自动调整出价以优化效果目标的策略。

在广告订单级别，订单项的 markupType 不能设置为 PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM。

此外，分配给广告订单的 performanceGoalType 值决定了该广告订单下订单项可用的 lineItemType 值：

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC和BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED仅允许LINE_ITEM_TYPE_DISPLAY_DEFAULT或LINE_ITEM_TYPE_VIDEO_DEFAULT订单项。
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA和BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN仅允许LINE_ITEM_TYPE_VIDEO_DEFAULT订单项。
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH仅允许 LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP 个订单项。
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

一种自动调整出价以达到或超越指定效果目标的策略。仅适用于订单项实体。
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

YouTube 及合作伙伴资源使用的出价策略。

它只能用于 YouTube 及合作伙伴订单项或广告组实体。
demandGenBid

object (DemandGenBiddingStrategy)

需求开发资源使用的出价策略。

只能用于需求开发广告订单项或广告组实体。
互斥字段结束。

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 可见的展示
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH 最大限度扩大覆盖面。

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 美元。
  • 当 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 出价数值在广告组中定义。

DemandGenBiddingStrategy

用于控制需求开发资源出价策略的设置。

JSON 表示法 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
字段
type

enum (DemandGenBiddingStrategyType)

可选。出价策略的类型。

只有在分配给订单项时才能设置此项。广告组会从其订单项继承此值。
value

string (int64 format)

可选。出价策略使用的价值。您可以在将素材资源分配给订单项或广告组时设置此属性。此字段仅适用于以下策略类型：

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

此字段的值以广告客户所用币种的微单位或广告支出回报率值表示。例如，1000000 表示 1.0 个标准货币单位或 100% 的广告支出回报率值。如果未使用适用的策略，此字段的值将为 0。
effectiveBiddingValue

string (int64 format)

仅限输出。出价策略实际使用的价值。如果设置了，则此字段将与 value 相同。如果未设置 value，并且策略已分配给广告组，则此字段将沿用订单项的出价策略。

如果 type 不是 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 或 DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS，则此字段将为 0。
effectiveBiddingValueSource

enum (BiddingSource)

仅限输出。有效出价值的来源。

DemandGenBiddingStrategyType

需求开发广告系列资源的出价策略的可能类型。

枚举
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED 类型未指定或未知。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA 一种自动优化每美元转化次数的出价策略。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS 一种出价策略，可在达到目标广告支出回报率 (ROAS) 平均值的同时，自动尽可能提高收入。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS 一种自动尽可能提高转化次数的出价策略
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE 一种在不超出预算的前提下自动实现收入最大化的出价策略。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS 一种在给定预算范围内自动尽可能争取更多点击次数的出价策略。
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC 一种自动优化每次点击费用的出价策略。