BiddingStrategy

• JSON 表現
• FixedBidStrategy <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表現
• MaximizeSpendBidStrategy <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表現
• BiddingStrategyPerformanceGoalType
• PerformanceGoalBidStrategy <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表現
• YoutubeAndPartnersBiddingStrategy <ph type="x-smartling-placeholder">
  </ph>
  • JSON 表現
• YoutubeAndPartnersBiddingStrategyType
• BiddingSource

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

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 は指定された通貨の請求単位以上、上限 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。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 の場合、上限は 1000.00、下限は 0.01 です。 例: BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定した場合、入札単価は、獲得可能な各インプレッションが視認可能になる確率に基づいて決まります。たとえば、視認範囲のインプレッション単価の目標が 200 円で、インプレッションが 40% の確率で視認できる場合、入札単価は 0.80 ドルの CPM（200 円の 40%）になります。 たとえば、1,500,000 は標準通貨単位または広告費用対効果の 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 に設定されている場合にのみ有効です。

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	動画の視聴 1 回あたりで設定可能な金額を支払う入札戦略。
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	入札単価の値は広告グループで定義されます。