Tracciare la riproduzione di base in JavaScript 2.x track-core-playback-on-javascript
Le istruzioni seguenti forniscono indicazioni per l’implementazione negli SDK 2.x.
-
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
.table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 23-align-center Nome variabile Descrizione Obbligatorio name
Nome file multimediale Sì mediaid
Identificatore univoco del file multimediale Sì length
Lunghezza del file multimediale Sì streamType
Tipo di flusso (vedi Costanti StreamType sotto) Sì mediaType
Tipo di file multimediale (vedi Costanti MediaType sotto) Sì Costanti
StreamType
:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Nome costante Descrizione VOD
Tipo di flusso per Video on Demand. LIVE
Tipo di flusso per il contenuto LIVE. LINEAR
Tipo di flusso per contenuti LINEAR. AOD
Tipo di flusso per audio on-demand. AUDIOBOOK
Tipo di flusso per audiolibro. PODCAST
Tipo di flusso per podcast. Costanti
MediaType
:table 0-row-2 1-row-2 2-row-2 Nome costante Descrizione Audio
Tipo di file multimediale per flussi Audio. Video
Tipo di file multimediale per i flussi Video. code language-none var mediaObject = MediaHeartbeat.createMediaObject(<MEDIA_NAME>, <MEDIA_ID, <MEDIA_LENGTH>, MediaHeartbeat.StreamType.VOD, <MEDIA_TYPE>);
-
Allega metadati
Facoltativamente, allega oggetti metadati standard e/o personalizzati alla sessione di tracciamento tramite variabili di dati di contesto.
-
Metadati standard
Implementazione dei metadati standard in JavaScript
note note NOTE Il collegamento dell’oggetto metadati standard all’oggetto multimediale è facoltativo. -
Riferimento API per le chiavi di metadati multimediali: Chiavi di metadati standard - JavaScript
Consulta il set completo dei metadati disponibili qui: Parametri audio e video
-
-
Metadati personalizzati
Crea un oggetto variabile per le variabili personalizzate e compila i dati per questo elemento multimediale. Ad esempio:
code language-js /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };
-
-
Tracciare l’intenzione di inizio riproduzione
Per iniziare a tracciare una sessione multimediale, effettua una chiamata
trackSessionStart
sull’istanza Media Heartbeat:code language-js mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
note tip TIP Il secondo valore è il nome dell’oggetto metadati multimediali personalizzati creato al passaggio 2. note important IMPORTANT trackSessionStart
tiene traccia delle intenzioni di riproduzione dell’utente, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare dati/metadati e per stimare la metrica QoS relativa al tempo di avvio (durata tratrackSessionStart
etrackPlay
).note note NOTE Se non utilizzi metadati personalizzati, invia semplicemente un oggetto vuoto per l’argomento data
intrackSessionStart
, come mostrato nella riga esterna di commento nell’esempio di iOS precedente. -
Tracciare l’inizio effettivo della riproduzione
Identifica l’evento dal lettore multimediale per l’inizio della riproduzione, dove viene eseguito il rendering del primo fotogramma del file multimediale sullo schermo ed effettua una chiamata
trackPlay
.code language-js mediaHeartbeat.trackPlay();
-
Tracciare il completamento della riproduzione
Identifica l’evento dal lettore multimediale per il completamento della riproduzione in cui l’utente ha guardato il contenuto fino alla fine ed effettua una chiamata
trackComplete
.code language-js mediaHeartbeat.trackComplete();
-
Tracciare la fine della sessione
Identifica l’evento dal lettore multimediale per lo scaricamento/la chiusura della riproduzione in cui l’utente chiude l’elemento multimediale e/o l’elemento multimediale viene completato e scaricato ed effettua una chiamata
trackSessionEnd
.code language-js mediaHeartbeat.trackSessionEnd();
note important IMPORTANT trackSessionEnd
indica la fine di una sessione di tracciamento. Se la sessione è stata guardata correttamente fino al completamento, dove l’utente ha guardato il contenuto fino alla fine, assicurati chetrackComplete
venga chiamato prima ditrackSessionEnd
. DopotrackSessionEnd
, qualsiasi chiamata APItrack*
viene ignorata, tranne la chiamatatrackSessionStart
per una nuova sessione di tracciamento video. -
Tracciare tutti gli scenari di pausa possibili
Identifica l’evento dal lettore multimediale per la pausa ed effettua una chiamata
trackPause
.code language-js mediaHeartbeat.trackPause();
Scenari di pausa
Identifica uno scenario in cui il lettore multimediale si interrompe e verifica che
trackPause
sia chiamato correttamente. I seguenti scenari richiedono tutti una chiamatatrackPause()
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) - Può verificarsi qualsiasi tipo di interruzione di sistema che porta l’applicazione in background. 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 l’elemento multimediale dal punto in cui è stato interrotto.
-
Identifica l’evento dal lettore per la riproduzione e/o la ripresa dalla pausa ed effettua una chiamata
trackPlay
:code language-js mediaHeartbeat.trackPlay();
note tip TIP Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Quando la riproduzione riprende, assicurati che ogni chiamata API trackPause()
sia associata alla seguente chiamata APItrackPlay()
.
- Scenari di tracciamento: Riproduzione VOD senza annunci
- Lettore di esempio incluso con l’SDK JavaScript per un esempio di tracciamento completo.