Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Funzioni: ganci per il ciclo di vita
Un hook del ciclo di vita definisce quando viene eseguita la funzione durante la riproduzione. MediaTailor Questa pagina è un riferimento completo per i campi di input, i namespace di output e le regole che regolano il flusso di dati in ogni hook.
Panoramica di
MediaTailor supporta due hook relativi al ciclo di vita:
-
PRE_SESSION_INITIALIZATIONsi attiva una volta quando uno spettatore inizia una nuova sessione. Usalo per operazioni di configurazione una tantum, ad esempio per recuperare segmenti di pubblico. A questo punto, non si è verificata alcuna interruzione pubblicitaria, quindi il contesto delle interruzioni pubblicitarie non è disponibile. -
PRE_ADS_REQUESTviene attivato prima di ogni richiesta dell'ad decision server (ADS), una volta per interruzione dell'annuncio nello stream. Utilizzalo per personalizzare la richiesta ADS con dati di targeting, modificare l'URL ADS o aggiungere intestazioni.
La differenza fondamentale è la tempistica: PRE_SESSION_INITIALIZATION viene eseguita una volta e imposta dati che persistono per l'intera sessione, mentre vengono PRE_ADS_REQUEST eseguiti ripetutamente e possono personalizzare ogni richiesta ADS in base all'interruzione pubblicitaria specifica.
Riferimento del campo di immissione
| Campo | Tipo | PRE_SESSION_INITIALIZATION | PRE_ADS_REQUEST |
|---|---|---|---|
session.id |
Long | ✓ | ✓ |
session.uuid |
Stringa | ✓ | ✓ |
session.client_ip |
Stringa | ✓ | ✓ |
session.user_agent |
Stringa | ✓ | ✓ |
session.referer* |
Stringa | ✓ | ✓ |
session.avail_duration_secs |
Long | ✗ | ✓ |
session.avail_duration_ms |
Long | ✗ | ✓ |
player_params.* |
Stringa | ✓ | ✓ |
event.id |
Stringa | ✓ | ✓ |
event.hook |
Stringa | ✓ | ✓ |
event.timestamp |
Stringa | ✓ | ✓ |
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 |
Stringa | ✗ | ✓ |
scte.segmentation_upid.assetId |
Stringa | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
Stringa | ✗ | ✓ |
scte.segmentation_upid.cueData.value |
Stringa | ✗ | ✓ |
scte.unique_program_id |
Int | ✗ | ✓ |
scte.archive_allowed_flag |
Booleano | ✗ | ✓ |
scte.delivery_not_restricted_flag |
Booleano | ✗ | ✓ |
scte.device_restrictions |
Int | ✗ | ✓ |
scte.no_regional_blackout_flag |
Booleano | ✗ | ✓ |
scte.segment_num |
Int | ✗ | ✓ |
scte.segments_expected |
Int | ✗ | ✓ |
scte.sub_segment_num |
Int | ✗ | ✓ |
scte.sub_segments_expected |
Int | ✗ | ✓ |
scte.avails_expected |
Long | ✗ | ✓ |
asset.* |
Stringa | ✗ | ✓ |
adsRequest.url |
Stringa | ✗ | ✓ |
adsRequest.method |
Stringa | ✗ | ✓ |
adsRequest.headers.<key> |
Stringa | ✗ | ✓ |
adsRequest.body |
Stringa | ✗ | ✓ |
* session.referer è presente solo quando un'intestazione Referer è inclusa nella richiesta di inizializzazione della sessione. Usalo $exists(session.referer) per controllare prima di accedere.
