BiddingStrategy

入札戦略を管理する設定です。入札単価は入札戦略によって決まります。

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.
}
フィールド
共用体フィールド bid_strategy_scheme。必須。bid_strategy_scheme は次のいずれかになります。
fixedBid

object (FixedBidStrategy)

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

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

予算を使い切ると同時に、パフォーマンス目標を重視して最適化するように入札単価を自動的に調整する戦略。

広告掲載オーダーレベルでは、広告申込情報の markupTypePARTNER_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

広告掲載オーダーの広告申込情報の lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT にする必要があります。

performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

指定したパフォーマンス目標を達成できるように入札単価を自動的に調整する戦略。広告申込情報エンティティでのみ使用します。

FixedBidStrategy

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

JSON 表現
{
  "bidAmountMicros": string
}
フィールド
bidAmountMicros

string (int64 format)

広告主の通貨のマイクロ単位での固定入札単価。広告掲載オーダー エンティティの場合、bidAmountMicros は 0 に設定する必要があります。広告申込情報のエンティティの場合、bidAmountMicros は指定された通貨の請求単位以上、上限 1, 000000000 以下である必要があります。

たとえば、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。performanceGoalTypeBIDDING_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 には上限があります。

  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA の場合、上限は 10, 000.00 USD です。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC の場合、上限は 1, 000.00 USD です。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM の場合、上限は 1, 000.00 USD です。
  • performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO の場合、上限は 1000.00、下限は 0.01 です。

例: BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定した場合、入札単価は、獲得可能な各インプレッションが視認可能になる確率に基づいて決まります。たとえば、視認範囲のインプレッション単価の目標が 200 円で、インプレッションが 40% の確率で視認可能となる場合、入札価格は CPM が 0.80 ドル(2 ドルの 40%)になります。

たとえば、1,500,000 は標準通貨単位または広告費用対効果の 1.5 単位を表します。

maxAverageCpmBidAmountMicros

string (int64 format)

入札可能な最大平均 CPM を、広告主の通貨のマイクロ単位で指定します。指定した通貨の請求単位以上の値を指定する必要があります。performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている場合は適用されません。

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

customBiddingAlgorithmId

string (int64 format)

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