Trovare un ID sessione o una chiave di debug DAI

Ogni stream utente è dotato di un ID sessione che viene salvato per le 48 ore successive a un evento. Le sessioni monitorate vengono salvate per 60 giorni. Puoi inserire l'ID sessione nel campo "Identificatore sessioni" del Monitoraggio attività di streaming (Stream Activity Monitor, SAM). I risultati di ricerca consentono di visualizzare dettagli relativi alle richieste di annunci degli utenti per risolvere i problemi di uno stream video.

Illustreremo i seguenti metodi per trovare un ID sessione:

• Trovare un ID sessione in un'app che usa l'SDK IMA
• Trovare un ID sessione quando si esamina il traffico HTTP
• Trovare un ID sessione da una richiesta HTTP emulata
• Trovare un ID sessione in una richiesta di streaming SSB

Utilizzare una chiave di debug per visualizzare l'attività o risolvere i problemi relativi a uno stream video ^(beta) 

Ricorrere a una chiave di debug costituisce un'alternativa per visualizzare l'attività o risolvere i problemi di uno stream video.

Puoi impostare o passare una chiave univoca per ogni stream o sessione per poter eseguire il debug dello streaming utilizzando SAM. Se utilizzi la stessa chiave in diverse sessioni, solo la sessione più recente è disponibile per la ricerca e il debug.

• Per gli streaming richiesti con l'SDK IMA, fai riferimento alla documentazione dell'SDK per la chiamata API per impostare la chiave.
• Per gli stream richiesti senza l'SDK IMA (SSB), passa una chiave di debug utilizzando il parametro dai-sam-id.

  _{Ad esempio: https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3}

Le chiavi non possono contenere informazioni che consentono l'identificazione personale degli utenti.

Trovare un ID sessione in un'app che usa l'SDK IMA

Quando utilizzi l'SDK IMA per creare un video stream, puoi chiamare un metodo per ottenere l'ID sessione. Per informazioni dettagliate su come ottenere l'ID nell'SDK di ogni piattaforma:

• SDK Android
• SDK iOS
• SDK tvOS
• SDK HTML5
• SDK Chromecast
• SDK Roku

Molti sviluppatori di applicazioni scelgono di acquisire l'ID sessione e di registrarlo in un log rendendolo disponibile per la risoluzione dei problemi di streaming.

L'ID sessione è essenziale per esaminare informazioni dettagliate sulla pubblicazione degli annunci nello stream di un utente, pertanto è utile implementare un metodo o una funzionalità nascosta nell'applicazione che ne consenta la facile individuazione.

Trovare un ID sessione quando si esamina il traffico HTTP

Le richieste HTTP in uno strumento di proxy possono essere monitorate da un'applicazione che utilizza l'SDK IMA.

Quando l'SDK IMA viene utilizzato per richiedere uno stream video con inserimento di annunci dinamici, sono presenti due richieste HTTP:

• La richiesta HTTP POST, che deve essere restituita con lo stato 201, a indicare la creazione di un nuovo stream.
• La richiesta HTTP GET inviata all'URL nel campo stream_manifest. *

Altre informazioni vengono restituite in una struttura JSON, tra cui il valore stream_id, che rappresenta l'ID di sessione da inserire nel campo "Identificatore sessioni".

Trovare un ID sessione da una richiesta HTTP emulata

Per emulare una sequenza di richieste HTTP da parte dell'SDK, puoi utilizzare il comando curl dal prompt della riga di comando, con l'ID contenuti e l'ID video desunti dall'URL di uno stream video on demand.

Per esempio, se l'ID contenuti è 12345 e l'ID video è sample-video:

1. Digita la seguente stringa nel prompt dei comandi:

   curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"

2. (Facoltativo) Esegui la pipe per python -mjson.tool per visualizzarlo in modalità di formattazione del codice.

Esempio di output*

{
"duration": 784,
"stream_id": "19b40be0-7942-44ca-97e0-fc7b27f14029",
"stream_manifest": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/master.m3u8",
"stream_type": "on_demand",
"subtitles": [ ... ],
"time_events_url": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/time-events.json"
}

^{* Potresti utilizzare l'URL stream_manifest per testare la riproduzione in un player HLS (ad esempio, nel browser web Safari).}

Trovare un ID sessione in una richiesta di streaming SSB

Quando l'SSB viene utilizzato per richiedere uno stream video con inserimento di annunci dinamici, sono presenti due richieste HTTP:

1. La richiesta HTTP GET, che deve essere restituita con lo stato 302, a indicare un reindirizzamento.
2. La richiesta HTTP GET inviata all'URL reindirizzato. Questo URL contiene l'"ID sessione" da inserire nel campo "Identificatore sessioni".

Inoltre puoi trovare un ID sessione monitorando le richieste HTTP in uno strumento proxy da un dispositivo mobile o da un'applicazione OTT.

Trovare l'ID sessione per una richiesta di streaming SSB utilizzando Chrome

1. Carica l'URL dello stream di contenuti in un browser.

   Per esempio, se l'ID contenuti è 12345 e l'ID video è sample-video, carica:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. Carica gli Strumenti per sviluppatori in Chrome.
3. Vai alla scheda Rete di Strumenti per sviluppatori.
4. Applica un filtro per le richieste che contengono dai.google.com.

5. Le prime due richieste inviate al dominio "dai.google.com" dovrebbero riferirsi a un file denominato "master.m3u8":

   Prima richiesta: la risposta 302

   

   Seconda richiesta: l'URL con l'ID sessione

   
6. Copia l'ID sessione e inseriscilo nel campo Identificatore sessione.

Per eventuali problemi relativi alla risoluzione dei problemi o a interruzioni del servizio DAI, contatta l'assistenza per i publisher.