ShinyStat Video AnalyticsSe 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:

<script src=”http://codicefl.shinystat.com/cgi-bin/getserver.cgi?USER=&CODE=101&RND=123″>
.

→ 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:

//creazione plugin da chiamare al caricamento del codice sulla pagina (codeVAReady==true)
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)

____________________________________________________________________________________________________________

*Indicare l’ID della categoria che si desidera associare al singolo video.
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.

____________________________________________________________________________________________________________

//funzione di configurazione da chiamare dopo la creazione del plugin
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

IMPORTANTE: la DURATA_VIDEO deve essere sempre passata in millisecondi

//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);

IMPORTANTE: la TEMPO_CORRENTE deve essere sempre passata in millisecondi
.

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.