L'API Monitoraggio attività di streaming (SAM) per l'inserimento di annunci dinamici (DAI) ti consente di ispezionare e risolvere i problemi relativi alle singole sessioni di visualizzazione di live streaming e video on demand (VOD).
Per ispezionare visivamente e risolvere i problemi di una singola sessione di visualizzazione di un live streaming o di un video on demand, utilizza lo strumento Monitoraggio attività di streaming nell'interfaccia utente di Google Ad Manager.
Per recuperare in modo programmatico i dati diagnostici di una sessione, utilizza la risorsa networks.daiSessions dell'API Ad Manager.
Comprendi i casi d'uso
Con l'API SAM, puoi automatizzare la diagnostica degli stream e risolvere i problemi di pubblicazione degli annunci nelle tue integrazioni DAI, ad esempio:
- Verifica la creazione della sessione di streaming: conferma i parametri, la modalità di unione di
STITCHEDoPOD_SERVING, la modalità di generazione dei report e i metadati dei contenuti che Google DAI riceve durante la creazione di una sessione di live streaming o VOD. - Controlla le richieste di annunci e le risposte: esamina i tag annuncio Video Ad Serving Template (VAST) e Video Multiple Ad Playlist (VMAP) in uscita, i codici di stato HTTP, le latenze delle risposte, i corpi delle risposte XML non elaborati e le catene di reindirizzamento dei wrapper.
- Risolvi i problemi relativi alle decisioni e alle creatività dei pod di annunci: verifica quali annunci Google DAI seleziona o elimina per ogni pod, la durata di ogni annuncio nel pod e il sistema di annunci di origine della creatività dell'annuncio.
- Monitora l'esecuzione del precaricamento degli annunci: determina se Google DAI precarica un pod di annunci e controlla la fase di precaricamento di ogni pod di annunci.
- Convalida le chiamate API DAI Ad Break e API DAI Pod Serving: verifica l'esecuzione effettiva delle interruzioni pubblicitarie, le durate degli annunci pubblicati e le durate degli slate inseriti rispetto alle chiamate API, come l'API DAI Ad Break e l'API DAI Pod Serving.
- Verifica il monitoraggio degli eventi degli annunci: verifica se i ping di monitoraggio lato client o lato server sono andati a buon fine e controlla le risposte HTTP degli ad server.
- Automatizza il monitoraggio e gli avvisi delle sessioni: analizza le voci dei risultati strutturati con una gravità
INFO,WARNINGoERRORper rilevare problemi di riproduzione o monetizzazione nei test di integrazione automatizzati e nelle pipeline di monitoraggio della produzione.
Scopri la risorsa di primo livello
L'API SAM fa parte dell'API REST di Google Ad Manager (beta) sull'endpoint admanager.googleapis.com ed espone il metodo di sola lettura networks.daiSessions.get. Puoi eseguire query su una risorsa DaiSession con un ID sessione DAI o una chiave di debug personalizzata. DAI conserva i record della sessione per un massimo di tre giorni dopo la riproduzione.
L'API SAM non supporta l'elenco di tutte le risorse DaiSession in una rete Google Ad Manager.
Ispeziona le risposte degli stream DAI con SAM
Per verificare in che modo Google DAI elabora le tue richieste di stream, esamina la risposta DaiSession:
- API DAI full-service: controlla il campo
creationContext.streamCreateRequestper verificare la chiamata di registrazione dello stream, controlla le mappeadSelectionseadPodsper esaminare le decisioni relative agli annunci ed esamina la mappaadBreaksper confermare le durate degli annunci uniti, delle creatività slate e dei contenuti sottostanti. - API DAI di pubblicazione pod: verifica che il campo
creationContext.stitchingTypesia impostato sul valorePOD_SERVING, confronta il campoadBreakIdnelle mappeadPodseadBreakscon le chiamate di richiesta del manifest o del segmento del pod e controlla i beacon di verifica lato server o dei contenuti multimediali nella mappatrackingPings. - API DAI Ad Break: associa il valore
breakSequencedi un oggettoAdBreakalla proprietàAdBreak.breakSequence.
Effettua la tua prima richiesta
Per configurare l'autenticazione e recuperare le risorse della sessione DAI, consulta Utilizza l'API Monitoraggio attività di streaming.