このページは Cloud Translation API によって翻訳されました。

BiddingStrategy

JSON 表現
FixedBidStrategy
- JSON 表現
MaximizeSpendBidStrategy
- JSON 表現
BiddingStrategyPerformanceGoalType
PerformanceGoalBidStrategy
- JSON 表現

入札戦略をコントロールする設定です。入札単価は入札戦略によって決まります。

JSON 表現

JSON 表現
{ // Union field `bid_strategy_scheme` can be only one of the following: "fixedBid": { object (`FixedBidStrategy`) }, "maximizeSpendAutoBid": { object (`MaximizeSpendBidStrategy`) }, "performanceGoalAutoBid": { object (`PerformanceGoalBidStrategy`) } // 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)
  }
  // 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)` 指定したパフォーマンス目標を達成できるように入札単価を自動的に調整する戦略です。広告申込情報エンティティでのみ使用されます。

FixedBidStrategy

固定入札単価を使用する戦略。

JSON 表現
{ "bidAmountMicros": string }

フィールド

フィールド
`bidAmountMicros`	`string (int64 format)` 固定入札単価（広告主の通貨の 100 万倍単位）。広告掲載オーダーエンティティの場合、`bidAmountMicros` は 0 に設定する必要があります。広告申込情報エンティティの場合、`bidAmountMicros` は指定された通貨の請求単位以上で、上限の 1000000000 以下である必要があります。たとえば、1500000 は 1.5 標準通貨を表します。

bidAmountMicros

string (int64 format)

固定入札単価（広告主の通貨の 100 万倍単位）。広告掲載オーダーエンティティの場合、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（広告主の通貨の 100 万倍単位）です。指定された通貨の請求対象単位以上を指定してください。たとえば、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` の場合、上限は 10, 000.00 USD です。 `performanceGoalType` が `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` の場合、上限は 1, 000.00 USD です。 `performanceGoalType` が `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` の場合、上限は 1, 000.00 USD です。 `performanceGoalType` が `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO` の場合、上限は 1, 000.00、下限は 0.01 です。例: `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` に設定した場合、獲得可能な各インプレッションが視認可能になる確率に基づいて入札単価が決定されます。たとえば、視認範囲のインプレッション単価が 200 円で、インプレッションが視認可能になる可能性が 40% の場合、入札単価は CPM 80 円（200 円の 40%）となります。たとえば、1500000 は通貨または ROAS 値の 1.5 標準単位を表します。
`maxAverageCpmBidAmountMicros`	`string (int64 format)` 入札可能な最大平均 CPM（広告主の通貨の 100 万倍単位）です。指定された通貨の請求対象単位以上を指定してください。`performanceGoalType` が `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` に設定されている場合は適用されません。たとえば、1500000 は 1.5 標準通貨を表します。
`customBiddingAlgorithmId`	`string (int64 format)` この戦略で使用されるカスタム入札アルゴリズムの ID。`performanceGoalType` が `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO` に設定されている場合にのみ適用されます。