Questa guida descrive la funzionalità dei metadati degli annunci supportata dall'API Video Stitcher. I metadati dell'annuncio vengono estratti da un annuncio VAST in una risposta del tag annuncio, contenente eventi di monitoraggio degli annunci e annunci correlati. L'URL del tag annuncio è configurato nella richiesta di creazione della sessione. Per ulteriori informazioni, consulta Gestire una sessione live e Gestire una sessione VOD.
Prima di iniziare
Assicurati di conoscere i concetti e la terminologia introduttivi dell'API Video Stitcher. Per ulteriori informazioni, consulta la panoramica tecnica.
Introduzione
I metadati dell'annuncio contengono gli eventi di monitoraggio degli annunci e gli annunci associati associati a un annuncio unito. Un evento di monitoraggio degli annunci contiene un ping di callback utilizzato per monitorare l'annuncio VAST e l'interazione dello spettatore. Un annuncio companion è un annuncio complementare all'annuncio VAST principale. In modalità di monitoraggio lato client, è tua responsabilità attivare gli eventi in base al comportamento dello spettatore.
Monitoraggio degli annunci lato server
In modalità di monitoraggio lato server, ogni URI del segmento dell'annuncio è racchiuso in un URI di reindirizzamento e l'API Video Stitcher gestisce l'elaborazione degli eventi di avanzamento ogni volta che il player richiede questi segmenti. Tuttavia, gli eventi di attività, come pause, non vengono gestiti dall'API Video Stitcher.
Monitoraggio degli annunci lato client
In modalità di monitoraggio lato client, è il client a dover attivare gli eventi. Per ulteriori dettagli, consulta la documentazione degli eventi.
Gli eventi di avanzamento devono essere attivati quando è trascorso il tempo specificato durante l'annuncio. Ad esempio, l'evento Start deve essere attivato all'inizio dell'annuncio. Per maggiori dettagli sugli eventi di avanzamento, consulta l'oggetto evento di avanzamento.
Gli eventi di attività devono essere attivati quando uno spettatore svolge un'attività specifica. Ad esempio, l'evento pause deve essere attivato quando lo spettatore mette in pausa il video dell'annuncio. Per maggiori dettagli sugli eventi di attività, consulta l'oggetto evento di attività.
Monitoraggio degli annunci lato client VOD
Un oggetto interstitials viene restituito nella risposta di una richiesta di creazione di una sessione VOD. Per istruzioni su come creare una sessione VOD, consulta la sezione su come creare una sessione VOD.
Gli annunci in-between contengono i metadati di ogni annuncio inserito. Quando la modalità di monitoraggio degli annunci del cliente è attivata, è responsabilità del cliente attivare gli eventi di monitoraggio quando necessario. Per ulteriori dettagli, consulta l'oggetto interstitials.
Monitoraggio degli annunci lato client dal vivo
L'API Video Stitcher inserisce continuamente gli annunci in un live streaming. Le informazioni sui metadati degli annunci vengono generate ogni volta che viene inserito un nuovo annuncio.
Per HLS, il valore AdMetadataURI per recuperare i metadati degli annunci si trova nel
#EXT-X-DATERANGE.
Per DASH, l'elemento AdMetadataURI per recuperare i metadati degli annunci si trova nell'elemento <EventStream> per ogni elemento <Period>.
Per maggiori dettagli, vedi come gestire il monitoraggio lato client in tempo reale.
Annunci companion
Gli annunci companion sono annunci supplementari che possono essere visualizzati insieme agli annunci lineari inseriti. Per maggiori dettagli, consulta l'oggetto annunci correlati.
Passaggi successivi
- Scopri come completare specifiche attività dell'API Video Stitcher.