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

# 歩留まりの最適化クイックスタートガイド
<a name="yield-optimization-quickstart"></a>

このガイドでは、再生設定で収量最適化を有効にし、それが機能することを確認する方法について説明します。

**目標:** このガイドの最後に、未入力の広告インベントリを APS からのプログラム広告で自動的に埋める再生設定があります。

## 前提条件
<a name="yield-optimization-quickstart-prereqs"></a>
+ ライブコンテンツソースを含む既存の MediaTailor 再生設定。
+ APS パブリッシャー ID。持っていない場合は[APS との統合](yield-optimization-integrating-aps.md)、「」を参照してください。

## ステップ 1: コンソールで yield Optimization を有効にする
<a name="yield-optimization-quickstart-step1"></a>

1. [MediaTailor コンソール](https://console.aws.amazon.com/mediatailor/home)を開きます。

1. 左側のナビゲーションペインで、**設定**を選択します。

1. 更新する再生設定を選択します。

1. **[編集]** を選択します。

1. yield **Optimization Settings** セクションを展開します (起動時に**新しい**バッジでマークされています）。セクションの説明には、「パブリッシャー ID、広告期間の制限、リージョンのターゲティングを含む」と記載されています。

1. 有効化ドロップダウンを**有効**に設定します。

1. 以下のフィールドに入力します。
   + **APS パブリッシャー ID**: パブリッシャーアカウントに関連付けられている APS パブリッシャー ID (例: `8caf35b3-402b-4d75-bab2-f2aef63a66d3`)。これを取得する方法については、[APS との統合](yield-optimization-integrating-aps.md)「」を参照してください。
   + **Minimum Unfilled Duration**: yield Optimization が埋めようとする秒単位の最小未入力期間。これを **15** 以上に設定します。APS 広告クリエイティブは通常 15 秒以上であるため、15 秒未満の値は広告を返しません。
   + **Amazon 広告リージョン**: 入札リクエストをルーティングする Amazon 広告リージョン。プライマリオーディエンス`Asia Pacific`に基づいて`Americas`、、`Europe`、または のいずれかを選択します。これは `YieldOptimizationConfiguration` API モデルの `Region`フィールドにマッピングされ、リージョン名は で説明されている APS リージョンに対応します[APS との統合](yield-optimization-integrating-aps.md)。
   + **OpenRTB テンプレート設定**: JSON テンプレート。開始点[テンプレートの例](yield-optimization-examples.md)については、「」を参照してください。コンソールは JSON 構文を検証し、エラーと警告をインラインで表示します。デフォルトのテンプレートには、コンソールのスターターテンプレートがあらかじめ入力されています。「[入札の構築とテンプレート化](yield-optimization-bid-construction.md)」を参照してください。

1. **[保存]** を選択します。

## ステップ 2: OpenRTB テンプレートを設定する
<a name="yield-optimization-quickstart-step2"></a>

コンソールには、OpenRTB テンプレート用の JSON エディタが用意されています。少なくとも、テンプレートには以下が含まれている必要があります。

```
{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}
```

必須フィールドがない場合、コンソールから警告が表示されます。

## ステップ 3: セッションを開始して確認する
<a name="yield-optimization-quickstart-step3"></a>

1. プレイヤーパラメータ (ユーザーエージェント、IP アドレスなど) を含む再生セッションを開始します。

1. 時間未入力の広告時間枠を待ちます。

1. `YieldOptimization.BidRequest` および の CloudWatch メトリクスを確認します`YieldOptimization.AdsInserted`。

`BidRequest` が出力しているが 0 `AdsInserted`の場合は、 の`RAW_BID_REQUEST`イベントをチェック`ads_interaction_log`して、テンプレートが有効な入札リクエストを生成していることを確認します。

## ステップ 2 (代替): API を使用して を設定する
<a name="yield-optimization-quickstart-step2-api"></a>

`YieldOptimizationConfiguration` パラメータで `PutPlaybackConfiguration` API を使用します。

```
aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'
```

## 次の手順
<a name="yield-optimization-quickstart-next-steps"></a>
+ APS に登録してパブリッシャー ID を取得するには、「」を参照してください[APS との統合](yield-optimization-integrating-aps.md)。
+ MediaTailor が入札リクエストを行うタイミングを決定する方法については、「」を参照してください[収量最適化の仕組み](yield-optimization-how-it-works.md)。
+ テンプレートの完全な例については、「」を参照してください[テンプレートの例](yield-optimization-examples.md)。