Configuración de Adobe Flash

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

Cómo obtener los archivos componentes

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

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

  1. Si actualmente tienes Adobe Flash CS3 abierto, cierra 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
    • Para 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 Analytics. Si desarrollas contenido Flash, pero no estás familiarizado con ActionScript 3, usa este componente. El componente de Analytics es un paquete de seguimiento completo. Solo tiene que arrastrar y soltar los componentes directamente en su etapa, realizar algunas configuraciones simples en el inspector de componentes y estará listo para etiquetar sus controles con el seguimiento de Analytics.

Component de AnalyticsLibrary. Si estás familiarizado con ActionScript 3, puedes usar el componente AnalyticLibrary. Arrastra el componente a tu biblioteca de Flash e importa las clases de seguimiento directamente a tu código de ActionScript.

Cómo usar el componente de Analytics

Utilice la analytics_flash.swc para implementar el seguimiento mediante el componente de Analytics. Coloca el componente en el directorio de componentes correcto y aparecerá en el panel de componentes (Window -Componentes).

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

Debido al modo en que Flash funciona con los componentes visuales, generalmente es mejor comenzar a realizar el seguimiento en el segundo marco de tu aplicación Flash. Si necesita inicializar el seguimiento en el primer fotograma, coloque las llamadas de seguimiento dentro de los controladores de eventos para asegurarse de que el componente se inicialice por completo en el contenido Flash.

Ejemplo de un componente simple de Analytics para Flash

En el siguiente fragmento de código, se muestra cómo hacer un 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(). Esto aumenta el recuento de páginas vistas de la página virtual /myGame1.

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

Cómo usar el componente AnalyticsLibrary

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

Inicializar el objeto de seguimiento

Mediante 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 string única que se utiliza para realizar un seguimiento de la actividad en su contenido Flash y publicarlo en la vista correcta (perfil) en su cuenta de Analytics.
  • El modo de seguimiento. Los parámetros válidos son Bridge o AS3.
  • El modo de depuración. Configura debug como false para el uso en producción y true para validación y solución de problemas.

Ejemplo de AnalyticsLibrary simple

En el siguiente ejemplo, existe un clip de película llamado playGame en el escenario. Se crea un nuevo objeto de seguimiento llamado tracker junto con un controlador de eventos que escucha un 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 el recuento de páginas vistas 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");
}