使用播放器變數

若要設定 AWS Elemental MediaTailor 將從播放器收到的資料傳送到 ADS，請在範本 ADS URL 中指定 player_params.<query_parameter_name> 變數。舉例來 MediaTailor說，如果播放程式將請求user_id中名為的查詢參數傳送至 ADS 請求中，請將該資料包含[player_params.user_id]在 ADS URL 設定中。

這可讓您控制 ADS 請求中包含的查詢參數。一般而言，您會新增 ADS 可辨識的特殊查詢參數至 ADS 請求 URL，並提供索引鍵-值組做為參數的值。

以下程序中使用的範例會使用以下索引鍵-值組：

• param1 具有值 value1:

• param2 具有值 value2:

新增查詢參數做為索引鍵-值組

1. 在 AWS Elemental MediaTailor 中，設定 ADS 請求範本 URL 以參考參數。以下 URL 示範包含範例參數：

   https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

2. (選用) 針對伺服器端廣告追蹤報告，將播放器上的索引鍵-值組以 URL 編碼。當 MediaTailor 收到會話初始化請求時，它會在將值替換到 ADS 請求 URL 之前，URL 將其解碼一次。

   注意

   如果您的 ADS 需要 URL 編碼的值，請在播放器上將該值以 URL 編碼兩次。這樣，通過完成的解碼 MediaTailor 會為 ADS 產生一次編碼的值。

   例如，如果傳送到 ADS 的值經解碼的表示為 param1=value1:&param2=value2:，則 URL 編碼的表示為 param1=value1%3A&param2=value2%3A。

3. 在來自播放程式的工作階段初始化呼叫中，將索引鍵值配對傳遞給作 MediaTailor 為單一查詢參數的值。以下範例呼叫可提供用於伺服器和用戶端廣告追蹤報告的範例索引鍵-值組。

   • 伺服器端廣告追蹤報告的範例請求 - 使用 URL 編碼配對

     HLS：

     <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

     DASH：

     <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

   • 用戶端廣告追蹤報告的範例請求 - 沒有 URL 編碼

     HLS：

     POST <master>.m3u8
         {
             "adsParams": {
                "param1": "value1:",
                "param2": "value2:"
            }
         }

     DASH：

     POST <manifest>.mpd
         {
             "adsParams": {
                "param1": "value1:",
                "param2": "value2:"
            }
         }

對於伺服器端報告，請在收到播放程式要求時 MediaTailor 解碼參數。對於用戶端報告，它不會改變 JSON 承載中接收的參數。 MediaTailor 向 ADS 發送以下請求：

https://my.ads.com/<path>?param1=value1:&param2=value2:

以此方式，param1 和 param2 索引鍵-值組會包含在 ADS 請求中做為第一級查詢參數。