Seguimiento de Google Analytics para Adobe Flash

El componente Seguimiento de Google Analytics para Adobe Flash facilita la implementación de Google Analytics en tu contenido basado en Flash. Este componente, desarrollado por Adobe Systems, Inc., contiene todas las funciones del código JavaScript de Google Analytics. El componente de seguimiento de Flash es un objeto de seguimiento compilado nativo de ActionScript 3, que hace que la implementación de Analytics sea intuitiva en Flash y entornos de desarrollo Flex.

¿Por qué usar el seguimiento con Flash?

Sin el componente Seguimiento de Google Analytics para Adobe Flash, hacer un seguimiento del contenido de Adobe Flash con Google Analytics implica una serie de obstáculos técnicos. En primer lugar, debes desarrollar una interfaz personalizada para ga.js de modo que tu aplicación Flash pueda ejecutar el método apropiado de Analytics, como trackPageview() o trackEvent(). Además, también debes anticipar si tu contenido Flash tendrá acceso al Document Object Model (DOM) del navegador, ya que el seguimiento falla para los objetos en los que se deniega el acceso al DOM (por lo general, cuando tu contenido reside en sitios de terceros). Esto implica comprender cómo usar la llamada ExternalInterface en ActionScript 3 para acceder al DOM del navegador y para degradarse cuando se deniega el acceso.

El componente Google Analytics para Adobe Flash simplifica el seguimiento del contenido de Flash y administra el acceso al DOM correctamente. Es útil para varios fines de seguimiento comunes en Flash, como:

un widget de Flash incorporado en una página HTML
una aplicación flexible independiente o un sitio solo Flash alojado en una página HTML
un programa o juego Flex/Flash distribuido en el que el desarrollador no tiene control sobre la ubicación del widget

Tenga en cuenta que las aplicaciones de seguimiento en Flash tienen algunas variaciones estructurales con respecto a las páginas del sitio web de seguimiento. Estar familiarizado con el Seguimiento de Analytics es fundamental para comprender cómo funciona este complemento. También puedes consultar la documentación de diseño de este proyecto para obtener información detallada sobre cómo se transfirió el modelo de seguimiento de Analytics para este componente.

Nota: Por el momento, el seguimiento de Flash está disponible para cualquier contenido Flash incorporado en una página web. Por el momento, no se admite el seguimiento de datos enviados desde Adobe Air, Shockwave o el IDE Flash (p.ej., con la película de prueba).

Entornos de desarrollo compatibles

Puedes desarrollar el seguimiento de Analytics para Flash en entornos de Adobe Flash o Adobe Flex. Cada entorno requiere un componente diferente, que puedes descargar en http://code.google.com/p/gaforflash/. Estos componentes se basan en ActionScript 3 y se pueden configurar de una de estas dos maneras para cada entorno:

En Adobe Flash

Agrega y configura un componente simple en el inspector de componentes y arrástralo a la etapa.
Importa las bibliotecas de seguimiento de Flash directamente a tu biblioteca y comienza a programar.

En Adobe Flex

Incluye un componente MXML que puedas configurar desde un archivo MXML.
Importa las bibliotecas de seguimiento de Flash a tus etiquetas de secuencias de comandos o archivos AS3.

Volver al principio

¿Cómo funciona el componente?

Para utilizar el componente de seguimiento de Flash en su entorno, utilice las herramientas visuales de Flash o configure el objeto de seguimiento directamente en su código. Independientemente de si configuras el componente de forma visual o mediante código, debes proporcionar los siguientes elementos:

El ID de propiedad web: También se conoce como el número UA de tu código de seguimiento. Es similar a UA-xxxxx-yy, en el que las x y las y se reemplazan por los números correspondientes a tu cuenta y la información de vista (perfil) del objeto al que le haces un seguimiento. Consulta Propiedad web para obtener más información.
El modo de seguimiento: Elige el modo puente o el modo AS3. Este modo determina cómo se comunica su seguimiento con los servidores de Analytics y se describe en detalle a continuación.
Modo de depuración: Independientemente del entorno o modo de seguimiento que utilices, puedes activar la depuración para validar y probar tu seguimiento.

Modos de seguimiento

Según cómo distribuya su contenido de Flash, el componente de Analytics para Flash se comunica con los servidores de Analytics, ya sea conectando la comunicación entre el contenido de Flash en una instalación de seguimiento de Analytics existente o comunicándose directamente con los servidores de Analytics. Estos dos modos se denominan modo puente y modo AS3, respectivamente. Ambos modos utilizan la misma funcionalidad de seguimiento de Analytics y es fácil cambiar tu aplicación Flash de un modo a otro. Además de elegir un modo de comunicación para el seguimiento de Analytics, también puedes utilizar un modo de depuración para solucionar problemas o validar tu seguimiento.

En cualquier modo, allowscriptaccess debe ser igual a always para que funcione el seguimiento de la campaña. Este parámetro activa el acceso de lectura a la URL de la página y a la información de referencia que requiere el código de seguimiento de Flash. Sin allowscriptaccess, el código de seguimiento de Analytics se degrada de forma elegante. Proporcionan la mayoría de los datos de actividad del usuario, pero no confirmarán el modelo de atribución de campaña de Google Analytics.

Modo puente

Usa este modo si controlas tanto la página HTML como el contenido de Flash. Este modo funciona mejor si ya implementaste el seguimiento de Google Analytics (ga.js) en tu sitio web y quieres agregar el seguimiento al contenido Flash incorporado. El modo puente simplifica la comunicación entre Flash y JavaScript, ya que proporciona una interfaz unificada de ActionScript 3 al código ga.js. Proporciona la conexión entre las llamadas de ActionScript 3 y el código JavaScript de Analytics para que el seguimiento funcione.

La conexión con el código de seguimiento de Google Analytics se puede configurar a través del parámetro de ID de propiedad web de dos maneras:

Método más común. El objeto del código de seguimiento de Google Analytics ya existe en tu página con su propio nombre, como pageTracker. En este caso, se proporciona la referencia completa del DOM al objeto de seguimiento. Por ejemplo, si tu objeto se llama pageTracker, deberías hacer referencia a ese objeto en tu código como window.pageTracker. Por ejemplo, en el siguiente fragmento de código, se muestra cómo se configuraría con el entorno de Adobe Flex con ActionScript 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
Método alternativo. Si no creaste un objeto de seguimiento de páginas en tu página, simplemente puedes pasar el ID de propiedad web, y se creará un objeto de código de seguimiento de JavaScript para ti. Con este método, la referencia al archivo fuente de JavaScript base ga.js sigue siendo obligatoria en tu página HTML. En el siguiente fragmento de código, se muestra cómo se configuraría usando el entorno de Adobe Flex con ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

Para que el modo puente funcione correctamente, se debe establecer ExternalInterface.available como verdadero en el código de ActionScript 3. Esto también significa que allowScriptAccess se debe establecer en always en la página HTML que incorpora el contenido Flash. En el siguiente ejemplo, se muestra el código HTML configurado para el modo puente:

<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>

Volver al principio

Modo AS3

Utiliza este modo si controlas el código ActionScript 3 de Adobe Flash, pero no controlas el entorno de hosting de tu aplicación de Adobe Flash. Por ejemplo, si desarrollas contenido Flash para la distribución en muchos sitios, debes utilizar el modo AS3. El modo AS3 es completamente independiente del código de seguimiento ga.js y contiene todas las funciones de seguimiento de Analytics. No es necesario realizar una instalación de seguimiento de ga.js por separado con este modo. Además, el modo AS3 utiliza el mecanismo de almacenamiento Flash para realizar el seguimiento de la información de la sesión del usuario.

Para ciertos parámetros del DOM, como el idioma, el componente AS3 intenta recuperar los valores del navegador. Si no hay valores, el componente utiliza el valor equivalente de Flash o se establece de forma predeterminada como no.

Solución de problemas y validación

El componente Seguimiento de Google Analytics para Adobe Flash proporciona un modo de depuración para simplificar la validación y la solución de problemas. Si se habilita esta opción, todos los datos de seguimiento se interceptan y dirigen a una pantalla en un cuadro de texto en lugar de a los servidores de Analytics. De este modo, puedes ver en tiempo real los datos que, de otro modo, el servidor recopilaría. Esta función también ayuda a mantener los datos de prueba fuera de los datos de producción. Para habilitar la función de solución de problemas, configura la opción visualDebug como true en el inspector de componentes.

Ejemplos

Para ver ejemplos detallados sobre la implementación del seguimiento en los diferentes entornos de desarrollo, consulta lo siguiente:

Flash

Flex

Control de versiones

Puede encontrar la versión más reciente de los componentes de seguimiento en un archivo ZIP en http://code.google.com/p/gaforflash/downloads/list. Cada descarga contiene todos los componentes de seguimiento junto con la documentación relacionada. El nombre del archivo de descarga mostrará el número de versión del código que contiene.

También puedes usar las siguientes instrucciones en tu código para imprimir el número de versión actual del componente en la consola de salida.

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

Volver al principio