Come configurare ShinyStat Video Analytics per Javascript, Flash o Silverlight
Se per pubblicare i tuoi video utilizzi un player in Javascript, Flash o Silverlight, ecco come implementare ShinyStat Video Analytics
Se per pubblicare i tuoi video utilizzi un player in Javascript, Flash o Silverlight, puoi installare ShinyStat Video Analytics per analizzare la fruizione dei contenuti multimediali da parte degli utenti.
ShinyStat Video Analytics offre due diverse versioni:
- Versione per Javascript – ideale per:
– per quanti utilizzano un player in Javascript, Flash e Silverlight
– per quanti utilizzano player sviluppati con diverse tecnologie
– per quanti hanno la necessità di embeddare il player attraverso un iFrame - Versione per Adobe Flash – ideale per:
– per i player che utilizzano la sola tecnologia Adobe Flash
(in tal caso, il plugin viene scaricato da qualsiasi dominio sul quale è embeddato il player)
– per i siti sviluppati in Flash che prevedono un video al loro interno
Potrai scegliere la versione più adatta in funzione delle tue esigenze.
Una volta deciso quale versione utilizzare, basta disporre del codice sorgente del tuo player per configurare il servizio in pochi passaggi.
Vediamo insieme come procedere per implementare il servizio su un video player sviluppato in Javascript.
Per prima cosa dovrai inserire il seguente codice nel sorgente della pagina web:
→ Creazione del plugin
Prima di procedere, bisogna esser sicuri che il plugin sia stato scaricato completamente e che il codice di inizializzazione sia presente nella pagina.
A tal fine è necessario verificare che la variabile ‘codeVAReady’ sia valorizzata ‘true’ come nell’esempio seguente:
if(codeVAReady){
pluginVA = new videoAnalytics();
}
→ loadVideoAnalytics: funzione di inizializzazione
Una volta creata l’istanza della classe ‘videoAnalytics()’, questa dovrà essere inizializzata tramite la funzione loadVideoAnalytics con i seguenti parametri:
Parametro | Descrizione |
USER | User ShinyStat |
ID VIDEO | id univoco del video |
URL FILE VIDEO | url assoluto del video |
TIT VIDEO | titolo dato al video |
ID CATEGORIA | id categoria video (vedi pannello configurazione account) |
____________________________________________________________________________________________________________
Se desideri configurare le categorie per ottenere i dati relativi a gruppi di video, ti suggeriamo di configurarle prima di procedere all’implementazione del codice.
Per configurare una Categoria, è sufficiente accedere al pannello “Gestione categorie video”, raggiungibile cliccando su “Gestione account”>”Configurazione”>”Configura Categorie Video” nel menu a sinistra.
Una volta configurata la categoria, vedrai apparire l’ID categoria da inserire nel codice.
____________________________________________________________________________________________________________
pluginVA.loadVideoAnalytics(USER,ID VIDEO,URL FILE VIDEO,TIT VIDEO,ID CATEGORIA,’ ‘,0);
Attenzione: gli ultimi 2 parametri vanno lasciati inalterati (…,’ ‘,0) nello specifico stringa vuota e 0.
→ Funzioni di configurazione
Funzione da utilizzare al “Play” video.
Questa funzione va chiamata sia nel caso in cui il “Play” venga cliccato per iniziare la visione, sia successivamente ad un evento di stop
start(time)
time = DURATA_VIDEO
//funzione da chiamare allo start del video solo se la durata del video è valorizzata
pluginVA.start(DURATA_VIDEO);
stop: avvio del video
Funzione da utilizzare alla pausa/stop del play video.
pluginVA.stop();
seek: avvio del video
Funzione da utilizzare al seek del cursore sulla barra del video.
//Funzione di seek
pluginVA.setCurrentTime(TEMPO_CORRENTE);
Reset plugin per playlist video
In caso di presenza nello stesso player di più video consecutivi è necessario invocare nell’ordine le funzioni:
pluginVA.stop();
pluginVA.resetPlugin();
e successivamente la funzione:
//funzione di configurazione da chiamare dopo la creazione del plugin
pluginVA.loadVideoAnalytics(USER,ID VIDEO,URL FILE VIDEO,TIT VIDEO,ID CATEGORIA,’ ‘,TIPO PLAYER);
con i parametri del nuovo video.