Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# INITIALISATION AVANT LA SESSION
<a name="monetization-functions-hooks-pre-session"></a>

## Quand il se déclenche
<a name="monetization-functions-hooks-pre-session-when"></a>

MediaTailor exécute la fonction associée une `PRE_SESSION_INITIALIZATION` seule fois, au début d'une nouvelle session de lecture. La fonction s'exécute avant de MediaTailor construire la réponse manifeste initiale.

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

`session.*`, `player_params.*` et `event.*`. Pour tous les champs disponibles, voir[Référence du champ de saisie](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## Espace de noms de sortie autorisé
<a name="monetization-functions-hooks-pre-session-output"></a>


| Namespace | Types acceptés | 
| --- | --- | 
| player\_params.\* | Chaînes, nombres, booléens | 

Les valeurs écrites dans `player_params.*` sont conservées dans la session. Ils sont disponibles :
+ En tant qu'entrée lors du `PRE_ADS_REQUEST` cycle de vie, via `player_params.*`
+ Dans les URL de requête ADS via [MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md) (par exemple,`[player_params.deviceType]`)
+ Pendant toute la durée de la session, quel que soit le break publicitaire

**Note**  
La taille sérialisée totale de toutes les clés et valeurs de `player_params` sortie ne doit pas dépasser 1 000 caractères. Si le total dépasse cette limite, la sortie de la fonction est supprimée. Pour de plus amples informations, veuillez consulter [Limites des fonctions](monetization-functions-limits.md).

## Cas d'utilisation typiques
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ Récupérez les données d'identité ou d'audience auprès d'un service externe et stockez-les dans les paramètres du joueur pour les utiliser dans des requêtes ADS ultérieures.
+ Classez le type d'appareil en fonction de l'agent utilisateur et inscrivez la classification dans un paramètre du joueur.
+ Définissez les valeurs des paramètres du joueur par défaut sur lesquelles repose le traitement des interruptions de publicité en aval.
+ Stockez les valeurs dans les paramètres du joueur inclus dans l'URL ADS via[MediaTailor variables publicitaires dynamiques pour les demandes ADS](variables.md).

## Comportement de défaillance
<a name="monetization-functions-hooks-pre-session-failure"></a>

Si une fonction attachée à `PRE_SESSION_INITIALIZATION` échoue pour une raison quelconque, MediaTailor supprime la sortie de la fonction et procède comme si aucune fonction n'était attachée. La session démarre normalement sans les valeurs des paramètres du lecteur de la fonction.