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.
Caractéristiques du cycle de vie des fonctions
Un hook de cycle de vie définit le moment où MediaTailor votre fonction est exécutée pendant la lecture. Cette page est une référence complète pour les champs d'entrée, les espaces de noms de sortie et les règles qui régissent le flux de données à chaque hook.
Présentation de
MediaTailor prend en charge deux crochets de cycle de vie :
-
PRE_SESSION_INITIALIZATIONse déclenche une fois lorsqu'un utilisateur démarre une nouvelle session. Utilisez-le pour des tâches de configuration ponctuelles, telles que la récupération de segments d'audience. À ce stade, aucune coupure de publicité n'est survenue. Le contexte de coupure de publicité n'est donc pas disponible. -
PRE_ADS_REQUESTse déclenche avant chaque demande du serveur de décision publicitaire (ADS) : une fois par pause publicitaire dans le flux. Utilisez-le pour personnaliser la demande ADS avec des données de ciblage, modifier l'URL ADS ou ajouter des en-têtes.
La principale différence réside dans le timing : il PRE_SESSION_INITIALIZATION s'exécute une fois et définit les données qui sont conservées pendant toute la session, tout en étant PRE_ADS_REQUEST diffusées de manière répétée, et permet d'adapter chaque demande ADS à une pause publicitaire spécifique.
Référence du champ de saisie
| Champ | Type | INITIALISATION AVANT LA SESSION | DEMANDE PRÉALABLE AUX ANNONCES |
|---|---|---|---|
session.id |
Long | ✓ | ✓ |
session.uuid |
String | ✓ | ✓ |
session.client_ip |
Chaîne | ✓ | ✓ |
session.user_agent |
Chaîne | ✓ | ✓ |
session.referer* |
String | ✓ | ✓ |
session.avail_duration_secs |
Long | ✗ | ✓ |
session.avail_duration_ms |
Long | ✗ | ✓ |
player_params.* |
String | ✓ | ✓ |
event.id |
Chaîne | ✓ | ✓ |
event.hook |
Chaîne | ✓ | ✓ |
event.timestamp |
String | ✓ | ✓ |
avail.index |
Int | ✗ | ✓ |
avail.random |
Long | ✗ | ✓ |
avail.source_content_time_epoch_ms |
Long | ✗ | ✓ |
scte.event_id |
Int | ✗ | ✓ |
scte.avail_num |
Int | ✗ | ✓ |
scte.segmentation_event_id |
Int | ✗ | ✓ |
scte.segmentation_type_id |
Int | ✗ | ✓ |
scte.segmentation_upid |
String | ✗ | ✓ |
scte.segmentation_upid.assetId |
Chaîne | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
Chaîne | ✗ | ✓ |
scte.segmentation_upid.cueData.value |
String | ✗ | ✓ |
scte.unique_program_id |
Int | ✗ | ✓ |
scte.archive_allowed_flag |
Booléen | ✗ | ✓ |
scte.delivery_not_restricted_flag |
Booléen | ✗ | ✓ |
scte.device_restrictions |
Int | ✗ | ✓ |
scte.no_regional_blackout_flag |
Booléen | ✗ | ✓ |
scte.segment_num |
Int | ✗ | ✓ |
scte.segments_expected |
Int | ✗ | ✓ |
scte.sub_segment_num |
Int | ✗ | ✓ |
scte.sub_segments_expected |
Int | ✗ | ✓ |
scte.avails_expected |
Long | ✗ | ✓ |
adsRequest.url |
String | ✗ | ✓ |
adsRequest.method |
Chaîne | ✗ | ✓ |
adsRequest.headers.<key> |
Chaîne | ✗ | ✓ |
adsRequest.body |
String | ✗ | ✓ |
* n'session.refererest présent que lorsqu'un en-tête Referer est inclus dans la demande d'initialisation de session. $exists(session.referer)À utiliser pour vérifier avant d'accéder.
