Configuración de Adobe Flash

Este documento abarca todo lo que necesitas saber para configurar el seguimiento de Google Analytics para Adobe Flash para el entorno de desarrollo de Adobe Flash.

Obtén los archivos de componentes

Los archivos componentes de seguimiento de Flash se comprimen en un solo archivo ZIP que puedes descargar en http://code.google.com/p/gaforflash/downloads/list.

Sigue las instrucciones del archivo readme.txt para instalar los componentes de Flash.

1. Si tienes Adobe Flash CS3 abierto actualmente, sal de la aplicación.
2. Crea un directorio Google en una de las siguientes ubicaciones:
   • Para Windows: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • En Mac OS X: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. Navega a la ubicación en la que descomprimiste el archivo ZIP del componente y copia los siguientes archivos en el directorio que creaste en el paso anterior:
   • lib/analytics_flash.swc: El componente de Analytics
   • lib/analytics.swc: El componente de la biblioteca de Analytics

Ambos componentes tienen la misma funcionalidad, pero se proporcionan como conveniencia para diferentes estilos de desarrollo.

Componente de estadísticas. Si desarrolla contenido Flash, pero no está familiarizado con ActionScript 3, utilice este componente. El componente de Analytics es un paquete de seguimiento completo. Simplemente arrastra y suelta los componentes directamente en tu etapa, realiza algunas configuraciones simples en el inspector de componentes y estarás listo para etiquetar tus controles con el seguimiento de Analytics.

Componente AnalyticsLibrary. Si conoces ActionScript 3, puedes usar el componente AnalyticLibrary. Arrastre el componente a su biblioteca Flash e importe las clases de seguimiento directamente en su código de ActionScript.

Cómo utilizar el componente de estadísticas

Utiliza el analytics_flash.swc para implementar el seguimiento a través del componente de Analytics. Coloca el componente en el directorio correspondiente, y este aparecerá en el panel Componentes (Ventana - Componentes).

1. Arrastra el componente a la etapa y asígnale un nombre de instancia en el diálogo Propiedades.
2. Configura el componente en el panel Inspector de componentes (Windows - Component Inspector):
   • Agrega tu ID de propiedad web de Analytics.
   • Selecciona el modo Puente o AS3.
   • Indica si la depuración visual está activada o desactivada.
3. En el código de ActionScript, agregue las llamadas de seguimiento de Google Analytics estándar a la instancia del componente que acaba de crear.

Debido al modo en que Flash funciona con los componentes visuales, generalmente es mejor comenzar el seguimiento en el segundo fotograma de tu aplicación Flash. Si debes inicializar el seguimiento en el primer fotograma, coloca las llamadas de seguimiento en controladores de eventos para asegurarte de que el componente se haya inicializado por completo en el contenido Flash.

Ejemplo de un componente Flash simple de Analytics

El siguiente fragmento de código muestra cómo se puede realizar el seguimiento de un botón en Flash cuando alguien hace clic en él. En este ejemplo, la instancia del botón se llama playGame en tu ActionScript. Cuando se hace clic en el botón, se llama al método onButtonClick, que a su vez invoca el método trackPageview(). De esta manera, se aumenta la cantidad de páginas vistas de la página virtual /myGame1.

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

Volver al principio

Cómo usar el componente AnalyticsLibrary

Utiliza el archivo analytics.swc para implementar el seguimiento a través del componente AnalyticsLibrary. Este componente te permite crear una instancia de un objeto de seguimiento directamente en tu código AS3. Una vez que el componente AnalyticsLibrary esté en la ubicación correcta, aparecerá en el panel Componentes. A continuación, puedes arrastrar el componente del panel Componentes a tu biblioteca y, desde allí, importar las bibliotecas al código de ActionScript.

Cómo inicializar el objeto de seguimiento

Utilizando el entorno de Adobe Flash, inicializa el objeto de seguimiento con los siguientes parámetros:

• Haz referencia al objeto de visualización actual. En el siguiente ejemplo, this hace referencia al objeto de visualización.
• El ID de propiedad web. El ID de propiedad web es la cadena única que se utiliza para realizar un seguimiento de la actividad en tu contenido Flash y enviarlo a la vista (perfil) correcta de tu cuenta de Analytics.
• El modo de seguimiento: Los parámetros válidos son Bridge o AS3.
• Modo de depuración: Establece debug como false para el uso en producción y como true para la validación y la solución de problemas.

Un ejemplo simple de AnalyticsLibrary

En el siguiente ejemplo, hay un clip de una película llamado playGame en el escenario. Se crea un nuevo objeto de seguimiento llamado tracker junto con un controlador de eventos que escucha el clic del mouse. Cuando se hace clic en el botón, se llama a la función onButtonClick. Para cada clic, el método trackPageview() aumenta la cantidad de vistas de página de la página virtual /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");
} 

Volver al principio