Tracciare la riproduzione di base in Chromecast

Questa documentazione tratta il tracciamento nella versione 2.x dell’SDK.

1. Configurazione del tracciamento iniziale

   Identifica quando l’utente attiva l’intenzione di riproduzione (l’utente fa clic su play e/o l’esecuzione automatica è attiva) e crea un’istanza MediaObject.

   Specifihe di MediaObject API:

   createMediaObject

   mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);
   

   Costanti StreamType:

   Media di ADBMobile

   Costanti MediaType:

   Media di ADBMobile

2. Allega metadati video

   Facoltativamente, puoi allegare oggetti metadati video standard e/o personalizzati alla sessione di tracciamento video attraverso variabili dei dati di contesto.

   • Metadati video standard

     Implementare i metadati standard in Chromecast

     NOTA

     Il collegamento dell’oggetto metadati video standard all’oggetto multimediale è facoltativo.

   • Metadati personalizzati

     Crea un oggetto variabile per le variabili personalizzate e lo popola con i dati del video. Ad esempio:

     /* Set custom context data */
     var customVideoMetadata = {
         isUserLoggedIn: "false",
         tvStation: "Sample TV station",
         programmer: "Sample programmer"
     };
     

3. Tracciare l’intenzione di inizio riproduzione

   Per iniziare il tracciamento di una sessione multimediale, chiama trackSessionStart sull’oggetto media.

   ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);
   

   IMPORTANTE

   trackSessionStart tiene traccia delle intenzioni di riproduzione dell’utente, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare i dati/metadati video e per stimare la metrica QoS del tempo per l’avvio (la durata tra trackSessionStart e trackPlay).

   NOTA

   Il secondo valore corrisponde al nome dell’oggetto metadati video personalizzato creato nel passaggio 2. Se non utilizzi metadati video personalizzati, è sufficiente inviare un oggetto vuoto per l’argomento data in trackSessionStart, come mostrato nella riga commento nell’esempio di iOS precedente.

4. Tracciare l’inizio effettivo della riproduzione

   Identifica l’evento dal lettore video relativo all’inizio della riproduzione video, dove viene eseguito il rendering del primo fotogramma del video sullo schermo, e chiama trackPlay:

   ADBMobile.media.trackPlay();
   

5. Aggiorna il valore della testina di riproduzione

   Aggiorna il valore della posizione di mediaUpdatePlayhead più volte quando la testina di riproduzione si sposta.
   Per il tracciamento dei video on-demand (VOD), il valore è specificato in secondi dall’inizio dell’elemento multimediale.
   Per lo streaming live, se il lettore non fornisce informazioni sulla durata del contenuto, il valore può essere specificato come il numero di secondi trascorsi dalla mezzanotte UTC di quel giorno.
   Nota: quando si utilizzano gli indicatori di avanzamento, è necessario specificare la durata del contenuto e la testina di riproduzione deve essere aggiornata come numero di secondi dall’inizio dell’elemento multimediale, a partire da 0.

   ADBMobile().mediaUpdatePlayhead(position)
   

6. Tracciare il completamento della riproduzione

   Identifica l’evento dal lettore video relativo al completamento della riproduzione video, in cui l’utente ha guardato il contenuto fino alla fine, e chiama trackComplete:

   ADBMobile.media.trackComplete();
   

7. Tracciare la fine della sessione

   Identifica l’evento dal lettore video relativo allo scaricamento/chiusura della riproduzione video, in cui l’utente chiude il video e/o il video viene completato e scaricato, e chiama trackSessionEnd:

   ADBMobile.media.trackSessionEnd();
   

   IMPORTANTE

   trackSessionEnd indica la fine di una sessione di tracciamento video. Se la sessione è stata vista correttamente fino al completamento, per cui l’utente ha guardato il contenuto fino alla fine, assicurati che trackComplete venga chiamato prima di trackSessionEnd. Dopo trackSessionEnd, qualsiasi chiamata API track* viene ignorata, tranne che la chiamata trackSessionStart per una nuova sessione di tracciamento video.

8. Tracciare tutti gli scenari di pausa possibili

   Identifica l’evento dal lettore video relativo alla sospensione video e chiama trackPause:

   ADBMobile.media.trackPause();
   

   Scenari di sospensione

   Identifica uno scenario in cui il lettore video si interrompe e verifica che trackPause sia chiamato correttamente. I seguenti scenari richiedono tutti una chiamata trackPause() dall’app:

   • L’utente mette esplicitamente in pausa l’app.
   • Il lettore si mette in pausa da solo.
   • (App per dispositivi mobili): l’utente mette l’applicazione in background, ma si desidera invece che l’app mantenga aperta la sessione.
   • (App per dispositivi mobili): si verifica una qualsiasi interruzione del sistema causando l’esecuzione in background dell’applicazione. Ad esempio, l’utente riceve una chiamata oppure la notifica da un’altra applicazione, ma desideri che l’applicazione mantenga aperta la sessione per dare all’utente l’opportunità di riprendere il video dal punto in cui è stato interrotto.

9. Identifica l’evento dal lettore relativo alla riproduzione e/o la ripresa del video dalla sospensione e chiama trackPlay:

   ADBMobile.media.trackPlay();
   

   SUGGERIMENTO

   Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Quando la riproduzione del video riprende, assicurati che ogni chiamata API trackPause() sia associata alla seguente chiamata API trackPlay().

• Scenari di tracciamento: riproduzione VOD senza annunci
• Lettore di esempio incluso nell’SDK di Chromecast per un esempio di tracciamento completo.