Configurazione di Adobe Flash

Questo documento fornisce tutte le informazioni necessarie per configurare il monitoraggio di Google Analytics per Adobe Flash per l'ambiente di sviluppo di Adobe Flash.

Scarica i file dei componenti

I file del componente di monitoraggio Flash vengono compressi in un unico file ZIP che puoi scaricare dalla pagina http://code.google.com/p/gaforflash/downloads/list.

Segui le istruzioni nel file readme.txt per installare i componenti Flash.

1. Se attualmente è aperto Adobe Flash CS3, esci dall'applicazione.
2. Crea una directory Google in una delle seguenti posizioni:
   • Per Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • Per Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. Vai alla posizione in cui hai decompresso il file ZIP del componente e copia i seguenti file nella directory creata nel passaggio precedente:
   • lib/analytics_flash.swc - Il componente di Analytics
   • lib/analytics.swc - Il componente Libreria di Analytics

Entrambi i componenti hanno le stesse funzionalità, ma vengono forniti per praticità in diversi stili di sviluppo.

Componente Analytics. Se sviluppi contenuti Flash, ma non hai dimestichezza con TrueView 3, utilizza questo componente. Il componente Analytics è un pacchetto di monitoraggio completo. Trascina i componenti direttamente sullo stage, effettua alcune semplici configurazioni nello strumento di controllo dei componenti ed è tutto pronto per codificare i tuoi controlli con il monitoraggio di Analytics.

Componente AnalyticsLibrary. Se hai dimestichezza con Actions3, puoi utilizzare il componente AnalyticLibrary. Trascina il componente nella libreria Flash e importa le classi di tracciamento direttamente nel codice Action.

Utilizzo del componente Analytics

Utilizza l'analytics_flash.swc per implementare il monitoraggio tramite il componente Analytics. Inserisci il componente nella directory Componenti corretta per visualizzarlo nel riquadro Componenti (Finestra - Componenti).

1. Trascina il componente sullo stage e assegnagli un nome di istanza nella finestra di dialogo Proprietà.
2. Configura il componente nel riquadro Controllo componenti (Windows - Controllo componenti):
   • Aggiungi il tuo ID proprietà web di Analytics.
   • Seleziona la modalità Bridge o AS3.
   • Indica se il debug visivo è attivato o disattivato.
3. Nel codice JavaScript, aggiungi le chiamate di tracciamento GA standard all'istanza del componente appena creato.

A causa del modo in cui Flash funziona con i componenti visivi, è generalmente preferibile iniziare il tracciamento sul secondo frame dell'applicazione Flash. Se devi inizializzare il monitoraggio sul primo frame, posiziona le chiamate di tracciamento all'interno di gestori di eventi per assicurarti che il componente sia completamente inizializzato all'interno dei contenuti Flash.

Esempio di componente Flash di Analytics semplice

Il seguente snippet di codice mostra come è possibile monitorare un pulsante in Flash quando un utente vi fa clic. In questo esempio, l'istanza del pulsante è denominata playGame nel tuo ActionScript. Quando si fa clic sul pulsante, viene richiamato il metodo onButtonClick, che a sua volta richiama il metodo trackPageview(). In questo modo, viene incrementato il numero di visualizzazioni di pagina per la pagina virtuale /myGame1.

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
} 

Torna all'inizio

Utilizzo del componente AnalyticsLibrary

Utilizza il file analytics.swc per implementare il monitoraggio tramite il componente AnalyticsLibrary. Questo componente consente di creare l'istanza di un oggetto di monitoraggio direttamente nel codice AS3. Una volta che il componente AnalyticsLibrary si trova nella posizione corretta, viene visualizzato nel riquadro Componenti. Successivamente, puoi trascinare il componente dal riquadro Componenti nella libreria e importare le librerie nel codice Action.

Inizializza l'oggetto di monitoraggio

Utilizzando l'ambiente Adobe Flash, inizializza l'oggetto di monitoraggio con i seguenti parametri:

• Fai riferimento all'oggetto display corrente. Nell'esempio seguente, this fa riferimento all'oggetto display.
• L'ID proprietà web. L'ID proprietà web è la stringa univoca utilizzata per tenere traccia dell'attività sui contenuti Flash e inviarla alla vista (profilo) corretta nel tuo account Analytics.
• Modalità di rilevamento. I parametri validi sono Bridge o AS3.
• Modalità di debug. Imposta debug su false per l'uso in produzione e su true per la convalida e la risoluzione dei problemi.

Esempio di semplice AnalyticsLibrary

Nell'esempio seguente, sullo stage è presente un clip di un film chiamato playGame. Viene creato un nuovo oggetto di monitoraggio denominato tracker con un gestore di eventi che rimane in ascolto dei clic del mouse. Quando si fa clic sul pulsante, viene richiamata la funzione onButtonClick. Per ogni clic, il metodo trackPageview() incrementa il numero di visualizzazioni di pagina per la pagina virtuale /myGame1.

import com.google.analytics.AnalyticsTracker;
import com.google.analytics.GATracker;
var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true );
playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick ( event:Event ):void
{
   tracker.trackPageview("/myGame1");
} 

Torna all'inizio