翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

## 起動時
<a name="monetization-functions-hooks-pre-session-when"></a>

MediaTailor は、新しい再生セッションの開始時に、 にマッピングされた関数を 1 `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>


| Namespace | 使用できるタイプ | 
| --- | --- | 
| player\_params.\* | 文字列、数値、ブール値 | 

に書き込まれた値は`player_params.*`セッションに保持されます。これらを使用できます。
+ を介した`PRE_ADS_REQUEST`ライフサイクルフックの入力として `player_params.*`
+ 経由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>
+ 外部サービスから ID または対象者データを取得し、後の ADS リクエストで使用するプレイヤーパラメータに保存します。
+ ユーザーエージェントに基づいてデバイスタイプを分類し、分類をプレイヤーパラメータに書き込みます。
+ ダウンストリーム広告時間枠処理が依存するデフォルトのプレイヤーパラメータ値を設定します。
+ を通じて ADS URL に含まれるプレイヤーパラメータに値を保存します[ADS リクエストの MediaTailor 動的広告変数](variables.md)。

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

にアタッチされた関数が何らかの理由で`PRE_SESSION_INITIALIZATION`失敗した場合、MediaTailor は関数の出力を破棄し、関数がアタッチされていないかのように続行します。セッションは通常、関数のプレイヤーパラメータ値なしで開始されます。