Tracciare la riproduzione di base in JavaScript 3.x

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

IMPORTANTE

Se implementi una versione precedente dell’SDK, puoi scaricare le Guide per sviluppatori qui: Scaricare gli 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.

    API createMediaObject

    Nome variabile Tipo Descrizione
    name stringa Stringa non vuota che indica il nome del file multimediale.
    id stringa Stringa non vuota che indica un identificatore del file multimediale univoco.
    length numero Numero positivo che indica la lunghezza del file multimediale in secondi. Usa 0 se la lunghezza è sconosciuta.
    streamType stringa
    mediaType Tipo di file multimediale (audio o video).

    Costanti StreamType:

    Nome costante Descrizione
    VOD Tipo di flusso per Video on Demand.
    AOD Tipo di flusso per audio on-demand.

    Costanti MediaType:

    Nome costante Descrizione
    Audio Tipo di file multimediale per flussi Audio.
    Video Tipo di file multimediale per i flussi Video.
    var mediaObject = ADB.Media.createMediaObject(<MEDIA_NAME>,
                                      <MEDIA_ID,
                                      <MEDIA_LENGTH>,
                                      <STREAM_TYPE>,
                                      <MEDIA_TYPE>);
    
  2. Allega metadati

    Facoltativamente, allega metadati standard e/o personalizzati alla sessione di tracciamento tramite variabili di dati di contesto.

    • Metadati standard

      NOTA

      L’aggiunta dei metadati standard è facoltativa.

    • Metadati personalizzati

      Crea un oggetto variabile per le variabili personalizzate e compila i dati per questo elemento multimediale. Ad esempio:

      /* Set context data */
       var contextData = {};
      
       //Standard metadata
       contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode";
       contextData[ADB.Media.VideoMetadataKeys] = "Sample Show";
      
       //Custom metadata
       contextData["isUserLoggedIn"] = "false";
       contextData["tvStation"] = "Sample TV Station";
      
  3. Tracciare l’intenzione di avviare la riproduzione

    Per iniziare a tracciare una sessione multimediale, chiama trackSessionStart sull’istanza Media Heartbeat:

    var mediaObject = ADB.Media.createMediaObject("video-name",
                                                  "video-id",
                                                  60.0,
                                                  ADB.Media.StreamType.VOD,
                                                  ADB.Media.MediaType.Video);
    
    var contextData = {};
    
    //Standard metadata
    contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode";
    contextData[ADB.Media.VideoMetadataKeys] = "Sample Show";
    
    //Custom metadata
    contextData["isUserLoggedIn"] = "false";
    contextData["tvStation"] = "Sample TV Station";
    
    tracker.trackSessionStart(mediaObject, contextData);
    
    IMPORTANTE

    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 tra trackSessionStart e trackPlay).

    NOTA

    Se non utilizzi contextData, invia semplicemente un oggetto vuoto per l’argomento data in trackSessionStart.

  4. 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, e chiama trackPlay:

    tracker.trackPlay();
    
  5. Tracciare il completamento della riproduzione

    Identifica l’evento dal lettore multimediale per il completamento della riproduzione dove l’utente ha guardato il contenuto fino alla fine e chiama trackComplete:

    tracker.trackComplete();
    
  6. Monitorare la fine della sessione

    Identifica l’evento dal lettore multimediale per lo scaricamento/la chiusura della riproduzione in cui l’utente chiude il file multimediale e/o il file multimediale è stato completato e scaricato e chiama trackSessionEnd:

    tracker.trackSessionEnd();
    
    IMPORTANTE

    trackSessionEnd segna la fine di una sessione di tracciamento. Se la sessione è stata controllata correttamente al completamento, dove l’utente ha guardato il contenuto fino alla fine, assicurati che trackComplete venga chiamato prima di trackSessionEnd. Qualsiasi altra chiamata API track* viene ignorata dopo trackSessionEnd, tranne trackSessionStart per una nuova sessione di tracciamento.

  7. Tracciare tutti gli scenari di pausa possibili

    Identifica l’evento dal lettore multimediale per la pausa e chiama trackPause:

    tracker.trackPause();
    

    Scenari di pausa

    Identifica uno scenario in cui il lettore multimediale si mette in pausa e assicurati che trackPause venga chiamato correttamente. I seguenti scenari richiedono tutti una chiamata all’app trackPause():

    • 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 desideri 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 l’elemento multimediale dal punto in cui è stato interrotto.
  8. Identifica l’evento dal lettore per la riproduzione e/o la ripresa dalla pausa e dalla chiamata trackPlay:

    tracker.trackPlay();
    
    SUGGERIMENTO

    Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Assicurati che ogni chiamata API trackPause() sia associata alla seguente chiamata API trackPlay() quando la riproduzione riprende.

In questa pagina