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)

入札できる平均 CPM の上限（広告主様の通貨のマイクロ単位）。指定された通貨の請求単位以上である必要があります。

たとえば、1500000 は、通貨の 1.5 標準単位を表します。
raiseBidForDeals

boolean

戦略で取引の最低価格が考慮されるかどうか。
customBiddingAlgorithmId

string (int64 format)

この戦略で使用されるカスタム入札アルゴリズムの ID。performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO に設定されている場合にのみ適用されます。

floodlightActivityConfigs で識別されていない Floodlight アクティビティを使用するカスタム入札アルゴリズムを割り当てると、エラーが返されます。

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 の場合、上限は 1, 000.00 米ドルです。
  • performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM の場合、上限は 1, 000.00 米ドルです。
  • performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO の場合、上限は 1, 000.00、下限は 0.01 です。

例: BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定すると、入札単価は、利用可能な各インプレッションが視認可能になる確率に基づいて決定されます。たとえば、視認可能 CPM の目標が 200 円で、インプレッションの視認性が 40% と予測された場合、入札単価は CPM 80 円（200 円の 40%）になります。

たとえば、1500000 は、通貨または広告費用対効果の標準単位の 1.5 倍を表します。
maxAverageCpmBidAmountMicros

string (int64 format)

入札できる平均 CPM の上限（広告主様の通貨のマイクロ単位）。指定された通貨の請求単位以上である必要があります。performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている場合、適用されません。

たとえば、1500000 は、通貨の 1.5 標準単位を表します。
customBiddingAlgorithmId

string (int64 format)

この戦略で使用されるカスタム入札アルゴリズムの ID。performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO に設定されている場合にのみ適用されます。

floodlightActivityConfigs で識別されていない Floodlight アクティビティを使用するカスタム入札アルゴリズムを割り当てると、エラーが返されます。

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 1 ドルあたりのコンバージョン数を自動的に最適化する入札戦略。
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 1 日の予算内でコンバージョン数を自動的に最大化する入札戦略。
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 入札単価は広告グループで定義されます。