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.
Pre-session initialisation
Quand ça se déclenche
MediaTailor exécute la fonction mappée PRE_SESSION_INITIALIZATION une 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, consultezRé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 player_params.* sont conservées dans la session. Ils sont disponibles :
-
En tant que saisie dans le hook
PRE_ADS_REQUESTdu cycle de vie viaplayer_params.* -
Dans ADS, demandez des URL via MediaTailor variables publicitaires dynamiques pour les demandes ADS (par exemple,
[player_params.deviceType]) -
Pendant toute la durée de la session pendant toutes les pauses publicitaires
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 ignoré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 lecteur pour les utiliser lors de requêtes ADS ultérieures.
-
Classez le type d'appareil en fonction de l'agent utilisateur et écrivez la classification dans un paramètre du joueur.
-
Définissez les valeurs de paramètres de lecteur par défaut sur lesquelles repose le traitement des pauses publicitaires en aval.
-
Stockez les valeurs dans les paramètres du lecteur qui sont inclus dans l'URL ADS viaMediaTailor variables publicitaires dynamiques pour les demandes ADS.
Comportement de défaillance
Si une fonction associé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.
