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

# PRE\_SESSION\_INITIALIZATION
<a name="monetization-functions-hooks-pre-session"></a>

## 當它觸發時
<a name="monetization-functions-hooks-pre-session-when"></a>

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

## Input
<a name="monetization-functions-hooks-pre-session-input"></a>

`session.*`、`player_params.*` 和 `event.*`。如需所有可用的欄位，請參閱 [輸入欄位參考](monetization-functions-hooks.md#monetization-functions-hooks-input-ref)。

## 允許輸出命名空間
<a name="monetization-functions-hooks-pre-session-output"></a>


| 命名空間 | 接受的類型 | 
| --- | --- | 
| player\_params.\* | 字串、數字、布林值 | 

寫入 的值`player_params.*`會保留到工作階段。它們可供使用：
+ 透過 作為`PRE_ADS_REQUEST`生命週期勾點的輸入 `player_params.*`
+ 透過 在 ADS 請求 URLs 中 [ADS 請求的 MediaTailor 動態廣告變數](variables.md)（例如 `[player_params.deviceType]`)
+ 所有廣告休息時間的工作階段生命週期

**注意**  
所有`player_params`輸出索引鍵和值的總序列化大小不得超過 1，000 個字元。如果總計超過此限制，則會捨棄函數輸出。如需詳細資訊，請參閱[函數限制](monetization-functions-limits.md)。

## 典型使用案例
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ 從外部服務擷取身分或對象資料，並將其存放在玩家參數中，以供稍後的 ADS 請求使用。
+ 根據使用者代理程式分類裝置類型，並將分類寫入玩家參數。
+ 設定下游廣告休息時間處理所依賴的預設玩家參數值。
+ 將值儲存在透過 包含在 ADS URL 中的玩家參數中[ADS 請求的 MediaTailor 動態廣告變數](variables.md)。

## 失敗行為
<a name="monetization-functions-hooks-pre-session-failure"></a>

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