翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 収量最適化の仕組み
<a name="yield-optimization-how-it-works"></a>

このページでは、 yield Optimization の内部メカニズムについて説明します。トリガーされるタイミング、タイミングの仕組み、他の MediaTailor 機能との相互作用について説明します。

## 収量最適化がトリガーされるタイミング
<a name="yield-optimization-how-it-works-triggers"></a>

MediaTailor は、APS に入札リクエストを行う前に 3 つの条件を評価します。3 つすべてが true である必要があります。

1. **収量の最適化が設定されています。**再生設定には、有効なパブリッシャー ID、リージョン、テンプレート`YieldOptimizationConfiguration`を持つ があります。

1. **十分な未入力期間。**プライマリ ADS レスポンスの後、広告時間枠の残りの未入力時間が設定された`MinimumUnfilledDuration`しきい値を超えています。

1. **十分なパーソナライゼーション残り時間。**APS リクエストを行い、レスポンスを処理するのに十分な時間がパーソナライゼーション予算に残ります。

いずれかの条件が満たされない場合、歩留まりの最適化はスキップされ、MediaTailor はプライマリ ADS 広告のみを続行します。

## アンダーフィルの計算方法
<a name="yield-optimization-how-it-works-underfill"></a>

1. MediaTailor は、SCTE シグナルから広告時間枠の合計期間を読み取ります。

1. MediaTailor は、プライマリ ADS によって (VAST 期間から) 返されるすべての広告の期間を合計します。

1. 未入力の期間は、合計ブレーク期間からプライマリ広告期間の合計を引いた値に等しくなります。

1. 未入力の期間が 以上である場合`MinimumUnfilledDuration`、収量の最適化が続行されます。

**例:** プライマリ ADS が 30 秒の広告を返す 60 秒の広告時間枠では、30 秒が未入力になります。`MinimumUnfilledDuration` が 15 に設定されている場合、収量最適化は残りの 30 秒間の広告をトリガーしてリクエストします。

## パーソナライゼーション時間管理
<a name="yield-optimization-how-it-works-timing"></a>

MediaTailor は、広告パーソナライゼーションのための厳格なタイミング予算内で動作します。yield Optimization は、プライマリ ADS リクエストが完了した後の*残りの*パーソナライゼーション時間を使用します。

**タイミングに影響するキー SDC (セーフ動的設定) フラグ:**


| フラグ | 説明 | 
| --- | --- | 
| maximumLivePersonalizationLatencyMs | ライブコンテンツのすべての広告パーソナライゼーション (プライマリ ADS と YO) の最大合計時間。 | 
| adsRequestTimeOutMilliseconds | プライマリ ADS リクエストのタイムアウト。 | 

**タイミングの動作:**
+ APS リクエストを開始するのに十分な時間が残っている場合、YO は完全にスキップされます ( `SkipPersonalizationTimeoutExceeded`メトリクスを発行します）。
+ APS リクエストが開始されても時間内に完了しない場合、タイムアウトします ( `Timeouts`メトリクスを発行します）。
+ MediaTailor は、APS HTTP リクエストと VAST 処理の両方に厳密なタイムアウトを適用して、パーソナライゼーションが制限内で完了するようにします。

## フェイルオープン動作
<a name="yield-optimization-how-it-works-fail-open"></a>

歩留まりの最適化は常に失敗します。次のいずれかが発生した場合、MediaTailor はプライマリ ADS 広告のみを続行します。
+ APS はエラー (4xx、5xx) を返します。
+ リクエストがタイムアウトします。
+ 入札レスポンスに有効な広告が含まれていません。
+ VAST 解析は、返されたすべての入札で失敗します。

視聴者の再生エクスペリエンスは、収量最適化の失敗によって中断されることはありません。

## APS レスポンスコード
<a name="yield-optimization-how-it-works-response-codes"></a>


| コード | 意味 | 
| --- | --- | 
| 200 | 広告による入札応答の成功。 | 
| 204 | 入札なし。リクエストは有効ですが、利用可能な入札はありませんでした。 | 
| 400 | リクエストが正しくありません (無効な JSON または必須フィールドがありません）。 | 
| 500 | APS サーバーエラー。 | 
| 503 | APS 過負荷 (バックプレッシャー信号）。 | 
| 429 | APS スロットリング。APS はリクエストのスロットリングを手動で開始しました。 | 

## 他の MediaTailor 機能とのやり取り
<a name="yield-optimization-how-it-works-interactions"></a>


| 機能 | 相互作用 | 
| --- | --- | 
| 広告決定サーバー設定 (ADSC) | インタラクションなし。ADSC はプライマリ ADS リクエストを制御します。YO は独立しています。 | 
| プリフェッチ | 現在のリリースでは YO ではサポートされていません。 | 
| オーバーレイ広告 | 現在のリリースでは YO ではサポートされていません。 | 

## 次の手順
<a name="yield-optimization-how-it-works-next-steps"></a>
+ テンプレートから入札リクエストを構築する方法については、「」を参照してください[入札の構築とテンプレート化](yield-optimization-bid-construction.md)。
+ 完全なフィールドリファレンスについては、「」を参照してください[ORTB フィールドリファレンス](yield-optimization-ortb-reference.md)。