使用播放器變數 - AWS Elemental MediaTailor

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

使用播放器變數

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

這可讓您控制要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 收到會話初始化請求時，它會在將它們替換到請求之前對值進行一次URL解碼。ADS URL

    注意

    如果您ADS需要URL編碼值，請在播放URL器上對該值進行兩次編碼。這樣，由 MediaTailor 完成的解碼會產生一次編碼的值。ADS

    例如，如果傳送至的值的解碼表示ADS為param1=value1:&param2=value2:，則 URL-coded 表示為。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要求中做為第一類查詢參數。