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

競價建構和範本

此頁面說明 MediaTailor 如何從您的範本建置 OpenRTB 競價請求、變數插補的運作方式，以及 MediaTailor 自動設定哪些值。

組態欄位

當您在播放組態上啟用產出最佳化時，您會提供四個欄位：

如何建構出價請求

當廣告休息時間剩餘未填滿的持續時間時，MediaTailor 會在下列步驟中建構出價請求：

主控台預設範本

當您在 MediaTailor 主控台中啟用產出最佳化時，會提供下列預先填入的範本做為起點。您應該為您的應用程式自訂值：

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field說明：

範本插補 (Mustache templating)

您的 ORTB 範本使用 Mustache 範本語法進行動態值替換。預留位置使用雙大括號 {{ }}。

可用的範本變數

您的 ORTB 範本可以使用 ADS URL 範本中可用的相同動態變數。這些包括工作階段變數 （例如，、{{session.client_ip}}){{session.user_agent}}、玩家參數 ({{player_params.*}})、資產中繼資料 ({{asset.*}})、時段內容 ({{avail.*}}) 和 SCTE 訊號資料 (){{scte.*}}。

如需可用變數的完整清單及其說明，請參閱 ADS 請求的 MediaTailor 動態廣告變數。如需 MediaTailor URL 如何在將玩家參數值替換為範本之前解碼，請參閱本頁編碼和解碼行為稍後的 。

ORTB 範本中最常用的變數為：

如何傳遞玩家參數

有兩種方式可在工作階段初始化期間傳遞玩家參數。

方法 1：使用 JSON 內文提出 POST 請求 （建議）

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

此方法為偏好方法，因為它可避免使用者代理程式字串等複雜值的 URL 編碼問題。

方法 2：URL 查詢參數

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

使用此方法時，值必須以 URL 編碼。MediaTailor URL 會在插入前解碼它們。

編碼和解碼行為

MediaTailor 在將玩家參數值插入範本之前，會先對玩家參數值執行一個層級的 URL 解碼。無論傳遞參數的方式為何 (POST 內文或 URL 查詢參數），這都適用。

解碼值的範例：

重點：

當變數遺失時會發生什麼情況

如果播放器未傳送範本中參考的參數 （例如，{{player_params.app_name}}但播放器參數app_name中沒有 )，則預留位置會解析為空字串 ""。

影響：如果空字串位於必要欄位 （如 app.bundle)，則出價請求會失敗並顯示 BidRequestConfigurationError。如果它在選用欄位中，則 APS 會收到一個空值，這可能會導致無競價 (HTTP 204) 回應。

MediaTailor 會自動設定哪些項目

MediaTailor 一律使用主控台組態中的值和目前時段內容來設定下列欄位。如果您在範本中包含這些項目，則會覆寫您的值：

後續步驟