使用玩家變數

配置 AWS Elemental (AWS Elemental) MediaTailor 若要將從播放器收到的資料傳送到 ADS，請在範本 ADS URL 中指定player_params.<query_parameter_name>變數。例如，如果播放器發送一個名為user_id在其請求 MediaTailor，若要在 ADS 請求中傳遞該數據，請包含[player_params.user_id]在 ADS URL 配置中。

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

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

• param1 具有值 value1:

• param2 具有值 value2:

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

1. AWS Elemental Melemental MediaTailor，會將 ADS 請求範本 URL 配置為參考參數。以下 URL 示範包含範例參數：

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

2. (選用) 針對伺服器端廣告追蹤報告，將播放器上的索引鍵-值組以 URL 編碼。時機 MediaTailor 會收到工作階段初始化請求，會先將值進行 URL 解碼，之後才將它們替代到 ADS 請求 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 請求中做為第一級查詢參數。