翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
PRE_SESSION_INITIALIZATION
起動時
MediaTailor は、新しい再生セッションの開始時に、 にマッピングされた関数を 1 PRE_SESSION_INITIALIZATION回実行します。この関数は、MediaTailor が最初のマニフェストレスポンスを構築する前に実行されます。
Input
session.*、player_params.*、および event.*。使用可能なすべてのフィールドについては、「」を参照してください入力フィールドリファレンス。
許可される出力名前空間
| Namespace | 使用できるタイプ |
|---|---|
player_params.* |
文字列、数値、ブール値 |
に書き込まれた値はplayer_params.*セッションに保持されます。これらを使用できます。
-
を介した
PRE_ADS_REQUESTライフサイクルフックの入力としてplayer_params.* -
経由URLs ADS リクエストの MediaTailor 動的広告変数 (例:
[player_params.deviceType]) -
すべての広告時間枠にわたるセッションの存続期間中
注記
すべてのplayer_params出力キーと値の合計シリアル化サイズは、1,000 文字を超えることはできません。合計がこの制限を超えると、関数出力は破棄されます。詳細については、「関数の制限」を参照してください。
一般的なユースケース
-
外部サービスから ID または対象者データを取得し、後の ADS リクエストで使用するプレイヤーパラメータに保存します。
-
ユーザーエージェントに基づいてデバイスタイプを分類し、分類をプレイヤーパラメータに書き込みます。
-
ダウンストリーム広告時間枠処理が依存するデフォルトのプレイヤーパラメータ値を設定します。
-
を通じて ADS URL に含まれるプレイヤーパラメータに値を保存しますADS リクエストの MediaTailor 動的広告変数。
失敗動作
にアタッチされた関数が何らかの理由でPRE_SESSION_INITIALIZATION失敗した場合、MediaTailor は関数の出力を破棄し、関数がアタッチされていないかのように続行します。セッションは通常、関数のプレイヤーパラメータ値なしで開始されます。
