本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Yield Optimization 快速入門指南
<a name="yield-optimization-quickstart"></a>

本指南會逐步引導您在播放組態上啟用 Yield Optimization，並驗證其是否有效。

**目標：**在本指南結尾處，您將有一個播放組態，自動使用來自 APS 的程式設計廣告填入未填滿的廣告庫存。

## 先決條件
<a name="yield-optimization-quickstart-prereqs"></a>
+ 具有即時內容來源的現有 MediaTailor 播放組態。
+ APS 發佈者 ID。[與 APS 整合](yield-optimization-integrating-aps.md) 如果您沒有 ，請參閱 。

## 步驟 1：在主控台中啟用產出最佳化
<a name="yield-optimization-quickstart-step1"></a>

1. 開啟 [MediaTailor 主控台](https://console.aws.amazon.com/mediatailor/home)。

1. 在左側導覽窗格中，選擇**組態**。

1. 選擇您要更新的播放組態。

1. 選擇**編輯**。

1. 展開**產出最佳化設定區段 **（在啟動時以**新**徽章標記）。區段描述讀取：「設定收益最佳化設定，包括發佈者 ID、廣告持續時間限制和區域目標。」

1. 將啟用下拉式清單設定為**已啟用**。

1. 填寫下列欄位：
   + **APS 發佈者 ID**：與您的發佈者帳戶相關聯的 APS 發佈者 ID （例如 `8caf35b3-402b-4d75-bab2-f2aef63a66d3`)。如需如何取得此項目[與 APS 整合](yield-optimization-integrating-aps.md)，請參閱 。
   + **最短未填充持續時間**：Yield Optimization 將嘗試填充的最短未填充持續時間，以秒為單位。將此設定為 **15** 或更高。低於 15 秒的值不會傳回廣告，因為 APS 廣告創作通常為 15 秒或更長。
   + **Amazon Ads 區域**：要路由出價請求的 Amazon Ads 區域。`Asia Pacific` 根據您的主要受眾選擇 `Europe`、 `Americas`或 之一。這會對應至 `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` 正在發出 但`AdsInserted`為 0，請檢查 中的`RAW_BID_REQUEST`事件`ads_interaction_log`，以確認您的範本正在產生有效的競價請求。

## 步驟 2 （替代）：使用 API 設定
<a name="yield-optimization-quickstart-step2-api"></a>

使用 `PutPlaybackConfiguration` API 搭配 `YieldOptimizationConfiguration` 參數：

```
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 的運作方式](yield-optimization-how-it-works.md)。
+ 若要查看完整的範本範例，請參閱 [範例 範本](yield-optimization-examples.md)。