View a markdown version of this page

Richiesta VAST - AWS Elemental MediaTailor
Quando utilizzarloCampi di configurazioneCome viene elaborata la richiestaCampi di rispostaIn che modo gli annunci analizzati si integrano con gli output degli hookComportamento di erroreEsempio: recupera gli annunci da un server pubblicitario secondario

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à.

Richiesta VAST

Quando utilizzarlo

Da utilizzare VAST_REQUEST quando la funzione deve recuperare gli annunci da un endpoint VAST (Video Ad Serving Template). MediaTailor invia la richiesta, analizza la risposta come VAST con i reindirizzamenti wrapper risolti e rende gli annunci analizzati disponibili per le tue espressioni di output. I casi d'uso più comuni includono il recupero degli annunci da un server pubblicitario secondario per integrare una breve risposta principale e il recupero di annunci o promozioni pubblicitarie da inserire nelle interruzioni pubblicitarie non compilate.

VAST_REQUESTle funzioni sono supportate negli hook POST_ADS_RESPONSE e nel PRE_MANIFEST_INSERTION ciclo di vita, da sole o come fasi all'interno di un esecutore. Gli annunci analizzati da una VAST_REQUEST funzione si integrano con gli output di tali hook con la massima fedeltà. Per informazioni dettagliate, vedi In che modo gli annunci analizzati si integrano con gli output degli hook.

Campi di configurazione

Una VAST_REQUEST funzione ha i seguenti campi:

  • Runtime: il linguaggio delle espressioni. Impostalo suJSONATA.

  • MethodType— Il metodo HTTP. I valori supportati sono GET (impostazione predefinita) ePOST.

  • Url: l'endpoint VAST a cui inviare la richiesta. È possibile utilizzare un URL statico o un'espressione JSonata che crea l'URL in modo dinamico. Un URL statico deve utilizzare lo schema. https

  • Intestazioni: le intestazioni HTTP da includere nella richiesta, specificate come coppie di nome e valore dell'intestazione. Usa la sintassi delle {%...%} espressioni per i valori di intestazione dinamici.

  • Corpo: il corpo della richiesta da inviare. Utilizzato con POST le richieste, ad esempio per inviare una richiesta di offerta OpenRTB. È possibile utilizzare un'espressione JSonata per creare il corpo in modo dinamico.

  • RequestTimeoutMilliseconds(obbligatorio) — Quanto tempo aspettare per una risposta.

  • Output: definisce i valori da produrre dopo il completamento della chiamata. Ogni voce associa una chiave di output a un'espressione che può fare riferimento all'responseoggetto, tra cuiresponse.parsedAds.

I limiti delle richieste HTTP che si applicano alle HTTP_REQUEST funzioni si applicano anche in questo caso. Per informazioni dettagliate, vedi Limits.

Come viene elaborata la richiesta

  1. Crea la richiesta: MediaTailor valuta le Body espressioni UrlHeaders, e rispetto allo stato corrente della sessione, quindi invia la richiesta. POSTle richieste vengono inviate con il tipo di application/json contenuto.

  2. Analizza la risposta: MediaTailor analizza il corpo della risposta come VAST. Se un annuncio è un wrapper VAST, MediaTailor segue la catena di reindirizzamento e la risolve nell'annuncio in linea finale. Le richieste di reindirizzamento wrapper vengono sempre inviate con, come richiesto dalla specifica VAST. GET Se il tuo endpoint restituisce un documento che contiene un URL VAST anziché VAST stesso (come fanno alcuni offerenti), concatena una HTTP_REQUEST fase che recupera l'URL, seguita da una fase che lo recupera. VAST_REQUEST

  3. Elabora gli annunci analizzati: MediaTailor valuta le espressioni nel blocco di output. Queste espressioni possono fare riferimento allo stato della sessione originale e all'responseoggetto.

Campi di risposta

Al termine della chiamata, puoi fare riferimento ai seguenti campi nelle tue espressioni di output:

Campo Tipo Description
response.parsedAds Array Gli annunci analizzati, con i reindirizzamenti del wrapper risolti. Ogni annuncio ha la stessa forma delle adsResponse.ads voci contenute nell'POST_ADS_RESPONSEhook:adId,,,,, durationSeconds adSystemadTitle, creativeId e. sequence mediaFiles trackingEvents Impostato su un array vuoto quando la chiamata ha esito negativo o la risposta non è VALIDA VAST.
response.statusCode Numero intero Il codice di stato HTTP restituito dall'endpoint. Impostato null su in caso di errore di rete.

Poiché gli annunci analizzati utilizzano la stessa formaadsResponse.ads, puoi spostare le espressioni tra le due superfici senza riscrivere i riferimenti ai campi.

In che modo gli annunci analizzati si integrano con gli output degli hook

Ogni annuncio analizzato da una VAST_REQUEST funzione viene conservato internamente MediaTailor, digitato dall'ID annuncio VAST dell'annuncio, per tutta la durata della chiamata all'hook. Ciò offre agli annunci analizzati un trattamento di prima classe nei risultati degli hook:

  • Se si aggiunge un annuncio analizzato per unitàPOST_ADS_RESPONSE, vengono adId ripristinati i adsResponse.ads dati VAST analizzati completi dell'annuncio, inclusi l'elenco completo dei file multimediali e gli eventi di tracciamento.

  • In AtPRE_MANIFEST_INSERTION, inserendo in un annuncio solo i relativi file multimediali, è MediaTailor possibile selezionare il vastAdId file multimediale migliore e gestire automaticamente la transcodifica della registrazione.

Importante

Gli annunci conservati non vengono trasferiti tra una chiamata e l'altra. Una VAST_REQUEST chiamata effettuata a non POST_ADS_RESPONSE è disponibile per una chiamata successiva. PRE_MANIFEST_INSERTION Chiama VAST_REQUEST la stessa catena di funzioni dell'hook in cui ne usi i risultati.

Comportamento di errore

Se la chiamata fallisce a causa di un errore di rete o di un timeout, se l'endpoint restituisce un errore HTTP o se la risposta non può essere analizzata come VAST, response.parsedAds è un array vuoto e la catena di funzioni continua. Controlla response.statusCode per distinguere un errore HTTP da una risposta VAST che non contiene effettivamente pubblicità.

Suggerimento

Resta strettoRequestTimeoutMilliseconds. La risoluzione del wrapper VAST può comportare più round trip di rete e tutti vengono conteggiati nel timeout dell'hook e nel budget dell'hook condiviso.

Esempio: recupera gli annunci da un server pubblicitario secondario

La seguente funzione recupera gli annunci da un server pubblicitario di backup e archivia gli annunci analizzati in dati temporanei. Un CUSTOM_OUTPUT passaggio successivo nella stessa sequenza può aggiungerli a. adsResponse.ads È progettato per il POST_ADS_RESPONSE ciclo di vita.

{
    "FunctionId": "fetchBackupAds",
    "FunctionType": "VAST_REQUEST",
    "VastRequestConfiguration": {
        "Runtime": "JSONATA",
        "MethodType": "GET",
        "Url": "{%'https://backup-ads.example.com/vast?sid=' & session.uuid%}",
        "Headers": {
            "Accept": "application/xml"
        },
        "RequestTimeoutMilliseconds": 1000,
        "Output": {
            "temp.backupAds": "{%response.parsedAds%}"
        }
    }
}

Per inviare invece una richiesta di offerta OpenRTB, imposta POST e fornisci la richiesta MethodType di offerta in. Body L'offerente deve restituire VAST nell'organo di risposta.

Per una panoramica completa di un esempio simile, vedi. Esempi di funzioni