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_REQUEST
Quando si attiva
MediaTailor esegue la funzione mappata PRE_ADS_REQUEST una volta per interruzione pubblicitaria, 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 di PRE_SESSION_INITIALIZATION avail.*scte.*, plus e adsRequest.* (url, method, headers, body). Per tutti i campi disponibili, vediRiferimento al campo di input.
Namespace di output consentito
| Namespace | Tipi accettati | Come viene utilizzato l'output |
|---|---|---|
player_params.* |
Stringhe, numeri, valori booleani | Sostituisce i parametri del player di sessione per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite. MediaTailor variabili pubblicitarie dinamiche per le richieste ADS |
session.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili di sessione per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. |
avail.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili di utilizzo per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. |
scte.* |
Stringhe, numeri, valori booleani | Sostituisce le variabili SCTE per questa interruzione pubblicitaria. Disponibile per l'URL della richiesta ADS tramite la sostituzione dinamica delle variabili. |
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 le 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 mantenute 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 instradare il traffico tra diversi server pubblicitari a scopo di A/B test.
-
Aggiungi dati di arricchimento (segmenti di pubblico, token di identità) all'URL o alle intestazioni della richiesta ADS.
-
Modifica in modo condizionale 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 non fosse collegata alcuna funzione. La richiesta ADS viene inviata utilizzando i parametri della sessione e della richiesta originali senza modifiche.
