Come configurare ShinyStat Video Analytics per Adobe Flash
Se per pubblicare i tuoi video utilizzi un player in Flash, ecco come configurare ShinyStat Video Analytics
Se per pubblicare i tuoi video utilizzi un player in Adobe Flash, 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
Tra le due versioni puoi scegliere quella che meglio risponde alle tue esigenze.
Se nel tuo caso è preferibile la versione per Adobe Flash, basta disporre del codice sorgente del tuo player per configurare il servizio in pochi passaggi. Vediamoli insieme.
Innanzitutto il video player deve essere sviluppato in Action Script 3.0.
Una volta appurato questo, seguire questi semplici passaggi:
– Aprire il sorgente del video player e chiamare il plugin come da esempio seguente:
import flash.display.Loader;
import flash.display.LoaderInfo;
import flash.net.URLRequest;
import flash.events.*;
import flash.system.Security;var _shLdr:Loader = new Loader();
var _shLdrInfo:LoaderInfo;
var _swfOBJ:String;
var USER:String = root.loaderInfo.parameters.USER;
var titoloVideo:String = “TITOLO VIDEO”
_shLdr.contentLoaderInfo.addEventListener(Event.COMPLETE,_statLOAD); _shLdr.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, noShinyStatConnection);
_shLdr.load(new URLRequest(“http://codicefl.shinystat.com/cgi-bin/getswf.cgi?idE=”+idEmb+”&us=”+USER+”&TYPE=101&RN=”+Math.random()*2147483647));
_swfOBJ = this.loaderInfo.url;
addChild(_shLdr);
}
function callLoadVideo() {
_shLdrSWF.loadVideoAnalytics(“file_video”,titoloVideo);
}
function _statLOAD(e:Event):void {
_shLdrInfo = e.target as LoaderInfo;
_shLdrSWF = _shLdrInfo.content;
_shLdrSWF.setupPlugin(callLoadVideo,idEmb,USER,_swfOBJ);
}
function noShinyStatConnection(e:IOErrorEvent) {
//funzione di gestione errore download Plugin
}
_loadStat();
– Il codice appena inserito restituisce al player video un plugin con le seguenti API :
setupPlugin(callLoadVideo:Function , idEmb:String , USER:String , _swfOBJ:String)
Prima chiamata assoluta al caricamento del plugin nel videoPlayer.
I parametri passati prevedono: il nome della funzione di callBack definita dall’utente che il plugin dovrà richiamare al suo scaricamento dal server ShinyStat, l’ID del tag object che contiene il player video sulla pagina, lo user dell’account ShinyStat e l’URL assoluta del video player.
loadVideoAnalytics(urlV:String , titoloVideo:String, idVideo:String, Categoria:int)
Funzione da invocare all’interno della funzione di callBack presente nel video player.
I parametri obbligatori sono:
urlVideo: nome del file video, assoluto o relativo.
titoloVideo: titolo da assegnare al video per identificarlo facilmente nei report
Parametri opzionali:
** idVideo: id univoco del video
Categoria: id univoco della categoria di apparteneza del video
startSTAT(durataVideo:int)
Funzione da invocare ad ogni evento PLAY del video.
Il parametro durataVideo: specifica la durata totale del video in esecuzione espressa in millisecondi;
stopSTAT()
Funzione da richiamare allo stop e pausa del video, ferma il conteggio delle statistiche di visione.
setCurrentTime(tempoCorrente:int)
Funzione da invocare dopo il trascinamento della barra di visione del video player.
Alla funzione va passato come parametro l’istante di tempo in cui il video viene riposizionato (espresso in millisecondi).
– Il codice HTML di embed del Video Player dovrà contenere obbligatoriamente le seguenti variabili per garantire il funzionamento corretto del plugin (le variabili sono evidenziate in grassetto)
<param name=”movie” value=”VideoPlayer.swf”/>
<param name=”allowscriptaccess” value=”always“/>
<param name=”allowfullscreen” value=”true”/>
<param name=”flashvars” value=”idE=ID_OBJECT&USER=USER_SHINYSTAT“/>
</object>
idE = id univoco del tag object che contiene il video player.
USER = nome dell’account ShinyStat (Business o Pro) che mostrerà i report del video.
In caso di playlist per la versione Adobe Flash è necessario re-inizializzare un nuovo plugin con la medesima procedura e rimuovere il precedente.