使用玩家變數

若要設定 AWS Elemental MediaTailor 將從玩家接收的資料傳送至 ADS，請在範本 ADS URL 中指定player_params.<query_parameter_name>變數。例如，如果玩家將名為 user_id的查詢參數傳送到 MediaTailor，以在 ADS 請求中傳遞該資料，請在 ADS URL 組態[player_params.user_id]中包含 。

這可讓您控制 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。

   注意

   如果您的 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 請求中做為第一級查詢參數。