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à.
Pre-ads richiesta
Quando si accende
MediaTailor esegue la funzione mappata PRE_ADS_REQUEST una volta per interruzione dell'annuncio, immediatamente prima di inviare la richiesta all'ADS. La funzione viene eseguita ogni volta che viene rilevata un'opportunità pubblicitaria durante l'elaborazione del manifesto.
Input
Tutti i campi daPRE_SESSION_INITIALIZATION, plus avail.*scte.*,asset.*, e adsRequest.* (url, method, headers, body). Per tutti i campi disponibili, consultaRiferimento del campo di immissione.
Namespace di output consentito
| Namespace | Tipi accettati | Come viene utilizzato l'output |
|---|---|---|
player_params.* |
Stringhe, numeri, valori booleani | Sostituisce i parametri del session player per questa interruzione pubblicitaria. Disponibile all'URL di richiesta ADS tramite. MediaTailor variabili pubblicitarie dinamiche per richieste ADS |
session.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili di sessione per questa interruzione pubblicitaria. Disponibile per l'URL di richiesta ADS tramite sostituzione dinamica delle variabili. |
avail.* |
Stringhe, numeri, valori booleani | Le sostituzioni utilizzano le variabili per questa interruzione pubblicitaria. Disponibile per l'URL di richiesta ADS tramite sostituzione dinamica delle variabili. |
scte.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili SCTE per questa interruzione pubblicitaria. Disponibile per l'URL di richiesta ADS tramite sostituzione dinamica delle variabili. |
asset.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili di metadati delle risorse (dai EXT-X-ASSET tag) per questa interruzione pubblicitaria. Disponibile per l'URL di richiesta ADS tramite sostituzione dinamica delle variabili. Per ulteriori informazioni sugli indicatori pubblicitari HLS, consulta Marcatori pubblicitari HLS. |
adsRequest.* |
Stringa | Sostituisce la richiesta ADS solo per questa interruzione pubblicitaria. Campi supportati:url,,method,headers.<name>. body Il url valore viene trattato come un modello e viene supportato MediaTailor variabili pubblicitarie dinamiche per richieste ADS dopo l'esecuzione della funzione. Non persistente. |
Nota
Tutti gli output dell'PRE_ADS_REQUESThook sono sostituzioni temporanee: si applicano solo alla richiesta ADS dell'interruzione pubblicitaria corrente e non vengono mantenuti nella sessione.
Esempio: riscrittura della richiesta ADS:
{ "Output": { "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}", "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}" } }
Questo sostituisce l'URL ADS e aggiunge un'intestazione personalizzata per l'interruzione pubblicitaria corrente.
Casi d'uso tipici
-
Riscrivi l'URL della richiesta ADS per indirizzare il traffico tra diversi server pubblicitari per i A/B test.
-
Aggiungi i dati di arricchimento (segmenti di pubblico, token di identità) all'URL o alle intestazioni della richiesta ADS.
-
Modifica condizionalmente i parametri della richiesta ADS in base ai dati del segnale o all'indice di disponibilità SCTE-35 .
Comportamento di errore
Se una funzione collegata a PRE_ADS_REQUEST fallisce per qualsiasi motivo, MediaTailor scarta l'output della funzione e procede come se nessuna funzione fosse collegata. La richiesta ADS viene inviata utilizzando la sessione originale e i parametri della richiesta senza modifiche.
