Monitoraggio di Google Analytics per Adobe Flash

Il componente Monitoraggio di Google Analytics per Adobe Flash semplifica l'implementazione di Google Analytics nei contenuti basati su Flash. Questo componente, sviluppato da Adobe Systems, Inc., contiene tutte le funzionalità del codice JavaScript di Google Analytics. Il componente di monitoraggio Flash è un oggetto di monitoraggio compilato nativo di JavaScript 3, che rende l'implementazione di Analytics intuitiva negli ambienti di sviluppo Flash e Flex.

Perché utilizzare il monitoraggio Flash?

Senza il componente Monitoraggio di Google Analytics per Adobe Flash, il monitoraggio dei contenuti di Adobe Flash con Google Analytics comporta una serie di ostacoli tecnici. Innanzitutto, devi sviluppare un'interfaccia personalizzata per ga.js in modo che l'applicazione Flash possa eseguire il metodo Analytics appropriato, ad esempio trackPageview() o trackEvent(). Inoltre, devi anche prevedere se i tuoi contenuti Flash avranno accesso al DOM (Document Object Model) del browser, poiché il tracciamento degli oggetti non va a buon fine per gli oggetti per i quali l'accesso al DOM è negato (in genere quando i contenuti si trovano su siti di terze parti). Ciò comporta la comprensione di come utilizzare la chiamata ExternalInterface in JavaScript 3 per accedere al DOM del browser e per ridurre le prestazioni quando l'accesso viene negato.

Il componente Google Analytics per Adobe Flash semplifica il monitoraggio dei tuoi contenuti Flash e gestisce con semplicità l'accesso DOM. È utile per una serie di scopi comuni di tracciamento in Flash, ad esempio:

  • un widget Flash incorporato su una pagina HTML
  • un'applicazione Flex standalone o un sito che accetta solo file Flash ospitato su una pagina HTML
  • un gioco o un programma Flex/Flash distribuito in cui lo sviluppatore non ha alcun controllo sulla posizione del widget.

Tieni presente che le applicazioni di monitoraggio in Flash presentano alcune varianti strutturali rispetto al monitoraggio delle pagine del sito web. La familiarità con il monitoraggio di Analytics è essenziale per capire come funziona questo plug-in. Puoi anche consultare la documentazione sulla progettazione di questo progetto per informazioni dettagliate su come è stato trasferito il modello di monitoraggio di Analytics per questo componente.

Nota. Attualmente, il monitoraggio Flash è disponibile per tutti i contenuti Flash incorporati in una pagina web. Al momento non è supportato il monitoraggio dei dati inviati da Adobe Air, Shockwave o tramite l'IDE Flash (ad es. utilizzando Test Movie).

Ambienti di sviluppo supportati

Puoi sviluppare il monitoraggio Analytics per Flash in ambienti Adobe Flash o Adobe Flex. Ogni ambiente richiede un componente diverso, che puoi scaricare da http://code.google.com/p/gaforflash/. Questi componenti sono basati su JavaScript 3 e possono essere impostati in due modi per ciascun ambiente:

In Adobe Flash

  • Aggiungi e configura un componente semplice nella finestra Controllo componenti e trascinalo sullo stage.
  • Importa le librerie di monitoraggio di Flash direttamente nella tua libreria e inizia la programmazione.

Con Adobe Flex

  • Includi un componente MXML configurato dal file am MXML.
  • Importa le librerie di monitoraggio Flash nei tag script/nei file AS3.

Come funziona il componente?

Per utilizzare il componente di monitoraggio Flash nel tuo ambiente, puoi utilizzare gli strumenti visivi in Flash oppure impostare l'oggetto di monitoraggio direttamente nel codice. Indipendentemente dal fatto che tu stia configurando il componente visivamente o tramite codice, fornisci i seguenti elementi:

  • ID proprietà web: noto anche come numero UA del tuo codice di monitoraggio e ha il seguente aspetto: UA-xxxxx-yy, dove le x e la y vengono sostituite dai numeri che corrispondono al tuo account e visualizza le informazioni (profilo) relative all'oggetto che stai monitorando. Per ulteriori informazioni, vedi Proprietà web.
  • la modalità di monitoraggio: scegli modalità bridge o AS3. Questa modalità determina il modo in cui il monitoraggio comunica con i server di Analytics ed è descritta dettagliatamente di seguito.
  • Modalità di debug: indipendentemente dall'ambiente o dalla modalità di monitoraggio che utilizzi, puoi attivare il debug per convalidare e testare il monitoraggio.

Modalità di monitoraggio

A seconda della modalità di distribuzione dei contenuti Flash, il componente Analytics per Flash comunica con i server di Analytics mediante il collegamento della comunicazione tra i contenuti Flash in un'installazione di monitoraggio di Analytics esistente o mediante la comunicazione diretta con i server di Analytics. Queste due modalità sono rispettivamente chiamate modalità bridge e modalità AS3. Entrambe le modalità utilizzano la stessa funzionalità di monitoraggio di Analytics ed è facile passare da una modalità all'altra dell'applicazione Flash. Oltre a scegliere una modalità di comunicazione per il monitoraggio di Analytics, puoi anche utilizzare una modalità di debug per risolvere i problemi o convalidare il monitoraggio.

In entrambe le modalità, il valore di allowscriptaccess deve essere uguale a always affinché il monitoraggio delle campagne funzioni. Questo parametro attiva l'accesso in lettura all'URL della pagina e alle informazioni sui referrer richieste dal codice di monitoraggio Flash. Senza allowscriptaccess, il codice di monitoraggio di Analytics si riduce correttamente. Fornisce ancora la maggior parte dei dati sull'attività utente, ma non confermerà il modello di attribuzione della campagna Google Analytics.

Modalità bridge

Utilizza questa modalità se hai il controllo sia della pagina HTML sia dei contenuti Flash. Questa modalità è ideale se hai già implementato il monitoraggio di Google Analytics (ga.js) sul tuo sito web e vuoi aggiungere il monitoraggio ai contenuti Flash incorporati. La modalità bridge semplifica la comunicazione da Flash a JavaScript fornendo un'interfaccia{5/} unificata al codice ga.js. Fornisce la connessione dalle chiamate di JavaScript 3 al codice JavaScript di Analytics affinché il monitoraggio funzioni.

La connessione al codice di monitoraggio di Google Analytics può essere configurata tramite il parametro ID proprietà web in uno dei due seguenti modi:

  • Metodo più comune. L'oggetto Codice di monitoraggio di Google Analytics esiste già nella pagina con il suo nome, ad esempio pageTracker. In questo caso, devi fornire il riferimento DOM completo dell'oggetto di monitoraggio. Ad esempio, se l'oggetto si chiama pageTracker, il riferimento all'oggetto nel codice sarà window.pageTracker. Ad esempio, lo snippet di codice riportato di seguito illustra come eseguire la configurazione utilizzando l'ambiente Adobe Flex con Action 3:
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • Metodo alternativo. Se non hai creato un oggetto di monitoraggio di pagina nella tua pagina, è sufficiente trasmettere l'ID proprietà web per creare automaticamente un oggetto codice di monitoraggio JavaScript. Con questo metodo, devi comunque fare riferimento al file di origine JavaScript di base ga.js nella pagina HTML. Lo snippet di codice riportato di seguito illustra come eseguire la configurazione utilizzando l'ambiente Adobe Flex con JavaScript 3:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Affinché la modalità bridge funzioni correttamente, ExternalInterface.available deve essere impostato su true nel codice di ActionScript 3. Ciò significa anche che allowScriptAccess deve essere impostato su always nella pagina HTML che incorpora i contenuti Flash. L'esempio seguente illustra il codice HTML configurato per la modalità bridge:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

 

Modalità AS3

Utilizza questa modalità se controlli il codice Adobe Flash Action 3 ma non l'ambiente di hosting della tua applicazione Adobe Flash. Ad esempio, se stai sviluppando contenuti Flash da distribuire su più siti, utilizzerai la modalità AS3. La modalità AS3 è completamente indipendente dal codice di monitoraggio ga.js e contiene tutte le funzionalità di monitoraggio di Analytics. Non è necessaria un'installazione del monitoraggio ga.js separata con questa modalità. Inoltre, la modalità AS3 utilizza il meccanismo di archiviazione Flash per tenere traccia delle informazioni sulla sessione dell'utente.

Per alcuni parametri DOM, come la lingua, il componente AS3 tenta di recuperare i valori dal browser. Se i valori non sono presenti, il componente utilizza il valore equivalente Flash o il valore predefinito è no.

Risoluzione dei problemi e convalida

Il componente Monitoraggio di Google Analytics per Adobe Flash offre una modalità di debug per semplificare la convalida e la risoluzione dei problemi. Quando questa opzione è abilitata, tutti i dati di monitoraggio vengono intercettati e indirizzati a una schermata di una casella di testo anziché ai server di Analytics. In questa modalità puoi visualizzare in tempo reale i dati che altrimenti verrebbero raccolti dal server. Questa funzionalità consente inoltre di mantenere i dati dei test al di fuori dei dati di produzione. Puoi attivare la funzionalità di risoluzione dei problemi impostando l'opzione visualDebug su true nella finestra Controllo componenti.

Esempi

Per esempi dettagliati sull'implementazione del tracciamento nei diversi ambienti di sviluppo, consulta quanto segue:

Flash

Flex

Controllo delle versioni

Puoi trovare la versione più recente dei componenti di monitoraggio sotto forma di file ZIP all'indirizzo http://code.google.com/p/gaforflash/downloads/list. Ciascun download contiene tutti i componenti di monitoraggio e la relativa documentazione. Il nome del file scaricato mostra il numero di versione del codice che contiene.

Puoi anche utilizzare le seguenti istruzioni nel codice per stampare il numero di versione corrente del componente nella console di output.

import com.google.analytics.API;
trace(API.version);