Show Menu
TOPICS×

Tenere traccia della riproduzione di base mediante JavaScript 3.x

Questa documentazione descrive il tracciamento nella versione 3.x dell’SDK. Se stai implementando versioni precedenti dell’SDK, puoi scaricare le Guide per gli sviluppatori qui: Download di SDK
  1. Configurazione iniziale tracciamento
    Identificare quando l'utente attiva l'intenzione di riproduzione (l'utente fa clic su play e/o la riproduzione automatica è attivata) e creare un'
    MediaObject
    istanza.
    Nome della variabile
    Tipo
    Descrizione
    name
    string
    Stringa non vuota che denota il nome del supporto.
    id
    string
    Stringa non vuota che denota un unico identificatore multimediale.
    length
    number
    Numero positivo che indica la lunghezza del supporto in secondi. Utilizzate 0 se la lunghezza è sconosciuta.
    streamType
    string
    # di flusso (collegamento alle costanti streamType) o stringa non vuota per indicare il tipo di flusso multimediale.
    mediaType
    # (collegamento alle costanti MediaType)
    Tipo di supporto (Audio o Video).
    StreamType
    costanti:
    Nome costante
    Descrizione  
    VOD
    Tipo di flusso per Video on Demand.
    LIVE
    Tipo di flusso per il contenuto LIVE.
    LINEAR
    Tipo di flusso per il contenuto LINEAR.
    AOD
    Tipo di flusso per Audio su richiesta.
    AUDIOBOOK
    Tipo di flusso per la Rubrica audio.
    PODCAST
    Tipo di flusso per Podcast.
    MediaType
    costanti:
    Nome costante
    Descrizione
    Audio
    Tipo di supporto per i flussi audio.
    Video
    Tipo di supporto per i flussi video.
    var mediaObject = ADB.Media.createMediaObject(<MEDIA_NAME>, <MEDIA_ID, <MEDIA_LENGTH>, <STREAM_TYPE>, <MEDIA_TYPE>);
  2. Allega metadati
    Se necessario, allegate metadati standard e/o personalizzati alla sessione di tracciamento tramite variabili di dati di contesto.
    • Metadati standard
      È possibile allegare i metadati standard.
    • Metadati personalizzati
      Create un oggetto variabile per le variabili personalizzate e inserite i dati per questo supporto. Ad esempio:
      /* Set context data */ var contextData = {}; //Standard metadata contextData[ADB.Media.VideoMetadataKeys.EPISODE] = "Sample Episode"; contextData[ADB.Media.VideoMetadataKeys.SHOW] = "Sample Show"; //Custom metadata contextData["isUserLoggedIn"] = "false"; contextData["tvStation"] = "Sample TV Station";
  3. Tenere traccia dell’intenzione di avviare la riproduzione
    Per avviare il tracciamento di una sessione multimediale, invocate
    trackSessionStart
    l’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.EPISODE] = "Sample Episode"; contextData[ADB.Media.VideoMetadataKeys.SHOW] = "Sample Show"; //Custom metadata contextData["isUserLoggedIn"] = "false"; contextData["tvStation"] = "Sample TV Station"; tracker.trackSessionStart(mediaObject, contextData);
    trackSessionStart
    tiene traccia delle intenzioni dell’utente in merito alla riproduzione, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare i dati/metadati e per stimare la metrica QoS time-to-start (la durata tra
    trackSessionStart
    e
    trackPlay
    ).
    Se non si utilizza contextData, è sufficiente inviare un oggetto vuoto per l'
    data
    argomento in
    trackSessionStart
    .
  4. Tracciare l’inizio effettivo della riproduzione
    Identificate l’evento dal lettore multimediale per l’inizio della riproduzione, dove viene riprodotto il primo fotogramma del file multimediale sullo schermo, e chiamate
    trackPlay
    :
    tracker.trackPlay();
  5. Tenere traccia del completamento della riproduzione
    Identificate l’evento dal lettore multimediale per il completamento della riproduzione, in cui l’utente ha guardato il contenuto fino alla fine, e chiamate
    trackComplete
    :
    tracker.trackComplete();
  6. Tenere traccia della fine della sessione
    Identificare l’evento dal lettore multimediale per lo scaricamento/la chiusura della riproduzione, in cui l’utente chiude il supporto e/o il supporto è stato completato e scaricato, e chiamare
    trackSessionEnd
    :
    tracker.trackSessionEnd();
    trackSessionEnd
    segna la fine di una sessione di tracciamento. Se la sessione è stata guardata con successo e l’utente ha guardato il contenuto fino alla fine, accertatevi che
    trackComplete
    venga chiamato prima
    trackSessionEnd
    . Qualsiasi altra chiamata
    track*
    API viene ignorata dopo
    trackSessionEnd
    , fatta eccezione per
    trackSessionStart
    una nuova sessione di tracciamento.
  7. Tenere traccia di tutti gli scenari di pausa possibili
    Identificare l’evento dal lettore multimediale per la pausa e la chiamata
    trackPause
    :
    tracker.trackPause();
    Pausa scenari
    Identificare qualsiasi scenario in cui il lettore multimediale si mette in pausa e assicurarsi che venga chiamato
    trackPause
    correttamente. Tutti gli scenari seguenti richiedono che la chiamata dell'app
    trackPause()
    :
    • L'utente interrompe esplicitamente la pausa nell'app.
    • Il lettore si mette nello stato Pausa.
    • (App
      mobili
      ) - L'utente mette l'applicazione in background, ma si desidera che l'app tenga aperta la sessione.
    • (App
      mobili
      ) - Si verifica qualsiasi tipo di interruzione del sistema che causa il background di un'applicazione. Ad esempio, l'utente riceve una chiamata, o si verifica un pop-up da un'altra applicazione, ma si desidera che l'applicazione mantenga in vita la sessione per dare all'utente la possibilità di riprendere il supporto dal punto di interruzione.
  8. Identificare l’evento dal lettore per la riproduzione e/o la ripresa dalla pausa e dalla chiamata
    trackPlay
    :
    tracker.trackPlay();
    Può trattarsi della stessa origine evento utilizzata nel passaggio 4. Assicurati che ogni chiamata
    trackPause()
    API sia associata a una chiamata
    trackPlay()
    API seguente quando la riproduzione riprende.