View a markdown version of this page

Yield Optimization 快速入門指南 - AWS Elemental MediaTailor
先決條件步驟 1：在主控台中啟用產出最佳化步驟 2：設定 OpenRTB 範本步驟 3：啟動工作階段並驗證步驟 2 （替代）：使用 API 設定後續步驟

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

Yield Optimization 快速入門指南

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

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

先決條件

  • 具有即時內容來源的現有 MediaTailor 播放組態。

  • APS 發佈者 ID。與 APS 整合 如果您沒有 ，請參閱 。

步驟 1：在主控台中啟用產出最佳化

  1. 開啟 MediaTailor 主控台。

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

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

  4. 選擇編輯。

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

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

  7. 填寫下列欄位：

    • APS 發佈者 ID：與您的發佈者帳戶相關聯的 APS 發佈者 ID （例如 8caf35b3-402b-4d75-bab2-f2aef63a66d3)。如需如何取得此項目與 APS 整合，請參閱 。

    • 最短未填充持續時間：Yield Optimization 將嘗試填充的最短未填充持續時間，以秒為單位。將此設定為 15 或更高。低於 15 秒的值不會傳回廣告，因為 APS 廣告創作通常為 15 秒或更長。

    • Amazon Ads 區域：要路由出價請求的 Amazon Ads 區域。Asia Pacific 根據您的主要受眾選擇 Europe、 Americas或 之一。這會對應至 YieldOptimizationConfiguration API 模型中的 Region 欄位，而區域名稱對應至 中所述的 APS 區域與 APS 整合。

    • OpenRTB 範本組態：您的 JSON 範本。如需起點範例 範本，請參閱 。主控台會驗證 JSON 語法，並內嵌顯示錯誤和警告。預設範本會預先填入主控台的入門範本。請參閱 競價建構和範本。

  8. 選擇儲存。

步驟 2：設定 OpenRTB 範本

主控台為 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：啟動工作階段並驗證

  1. 啟動播放工作階段，其中包含您的玩家參數 （使用者代理程式、IP 地址等）。

  2. 等待未填充持續時間的廣告休息時間。

  3. 檢查 YieldOptimization.BidRequest和 的 CloudWatch 指標YieldOptimization.AdsInserted。

如果 BidRequest 正在發出 但AdsInserted為 0，請檢查 中的RAW_BID_REQUEST事件ads_interaction_log，以確認您的範本正在產生有效的競價請求。

步驟 2 （替代）：使用 API 設定

使用 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}]}"
  }'

後續步驟