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
Quand il se déclenche
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
session.*, player_params.* et event.*. Pour tous les champs disponibles, voirRéférence du champ de saisie.
Espace de noms de sortie autorisé
| 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_REQUESTcycle de vie, viaplayer_params.* -
Dans les URL de requête ADS via MediaTailor variables publicitaires dynamiques pour les demandes ADS (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.
Cas d'utilisation typiques
-
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 viaMediaTailor variables publicitaires dynamiques pour les demandes ADS.
Comportement de défaillance
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.