View a markdown version of this page

PRE_SESSION_INITIALIZATION - AWS Elemental MediaTailor

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

PRE_SESSION_INITIALIZATION

當它觸發時

MediaTailor 會在新的播放工作階段PRE_SESSION_INITIALIZATION開始時執行一次映射至 的函數。函數會在 MediaTailor 建構初始資訊清單回應之前執行。

Input

session.*player_params.*event.*。如需所有可用的欄位,請參閱 輸入欄位參考

允許輸出命名空間

命名空間 接受的類型
player_params.* 字串、數字、布林值

寫入 的值player_params.*會保留到工作階段。它們可供使用:

  • 透過 作為PRE_ADS_REQUEST生命週期勾點的輸入 player_params.*

  • 透過 在 ADS 請求 URLs 中 ADS 請求的 MediaTailor 動態廣告變數(例如 [player_params.deviceType])

  • 所有廣告休息時間的工作階段生命週期

注意

所有player_params輸出索引鍵和值的總序列化大小不得超過 1,000 個字元。如果總計超過此限制,則會捨棄函數輸出。如需詳細資訊,請參閱函數限制

典型使用案例

  • 從外部服務擷取身分或對象資料,並將其存放在玩家參數中,以供稍後的 ADS 請求使用。

  • 根據使用者代理程式分類裝置類型,並將分類寫入玩家參數。

  • 設定下游廣告休息時間處理所依賴的預設玩家參數值。

  • 將值儲存在透過 包含在 ADS URL 中的玩家參數中ADS 請求的 MediaTailor 動態廣告變數

失敗行為

如果連接至 的函數因任何原因PRE_SESSION_INITIALIZATION失敗,MediaTailor 會捨棄函數的輸出,並像未連接函數一樣繼續進行。工作階段正常啟動,沒有函數的玩家參數值。