Scopri di più sull'API Stream Activity Monitor

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 STITCHED o POD_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, WARNING o ERROR per 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.streamCreateRequest per verificare la chiamata di registrazione dello stream, controlla le mappe adSelections e adPods per esaminare le decisioni relative agli annunci ed esamina la mappa adBreaks per confermare le durate degli annunci uniti, delle creatività slate e dei contenuti sottostanti.
  • API DAI di pubblicazione pod: verifica che il campo creationContext.stitchingType sia impostato sul valore POD_SERVING, confronta il campo adBreakId nelle mappe adPods e adBreaks con le chiamate di richiesta del manifest o del segmento del pod e controlla i beacon di verifica lato server o dei contenuti multimediali nella mappa trackingPings.
  • API DAI Ad Break: associa il valore breakSequence di un oggetto AdBreak alla 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.