本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 會捨棄函數的輸出,並像未連接函數一樣繼續進行。工作階段正常啟動,沒有函數的玩家參數值。