Seguimiento de Google Analytics para Adobe Flash

El 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 funcionalidades 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 los entornos de desarrollo Flash y flexible.

¿Por qué usar el seguimiento de Flash?

Sin el componente de seguimiento de Google Analytics para Adobe Flash, el seguimiento del contenido de Adobe Flash con Google Analytics implica una serie de problemas técnicos. Primero, debes desarrollar una interfaz personalizada para ga.js a fin de que tu aplicación Flash pueda ejecutar el método de Analytics adecuado, como trackPageview() o trackEvent(). Además, debe prever si su contenido Flash tendrá acceso al modelo de objetos del documento (DOM) del navegador, ya que el seguimiento falla para aquellos objetos en los que se niega el acceso al DOM (por lo general, cuando su 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 degradar cuando se niega el acceso.

El componente de Google Analytics para Adobe Flash simplifica el seguimiento del contenido Flash y controla el acceso al DOM de forma fluida. Es útil para una serie de propósitos de seguimiento comunes en Flash, como:

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

Recuerde que el seguimiento de aplicaciones en Flash tiene algunas variaciones estructurales a partir del seguimiento de páginas web. Conocer el seguimiento de Analytics es esencial para comprender cómo funciona este complemento. También puede consultar la documentación de diseño de este proyecto para obtener información detallada sobre la portabilidad del modelo de seguimiento de Analytics en este componente.

Nota: Actualmente, el seguimiento de Flash está disponible para cualquier contenido Flash incorporado en una página web. En este momento, no se admite el seguimiento de datos enviados desde Adobe Air, Shockwave o a través del IDE de Flash (por ejemplo, mediante película de prueba).

Entornos de desarrollo compatibles

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

En Adobe Flash

  • Agrega y configura un componente simple en el inspector de componentes y arrástralo a la etapa.
  • Importe las bibliotecas de seguimiento de Flash directamente a su biblioteca y comience a codificar.

En Adobe Flex

  • Incluye un componente MXML que configures a partir de un archivo MXML.
  • Importe las bibliotecas de seguimiento de Flash en las etiquetas de secuencias de comandos o los archivos AS3.

¿Cómo funciona el componente?

Para utilizar el componente de seguimiento de Flash en su entorno, puede utilizar las herramientas visuales de Flash o configurar el objeto de seguimiento directamente en su código. Independientemente de que configures 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 su código de seguimiento y se parece a UA-xxxxx-yy, donde los números x y y se reemplazan por los números que corresponden a su cuenta y la información de vista (perfil) del objeto de seguimiento. Consulta Propiedad web para obtener más información.
  • Modo de seguimiento: elija 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.
  • El modo de depuración: Independientemente del entorno o el modo de seguimiento que utilice, puede activar la depuración para validar y probar su seguimiento.

Modos de seguimiento

Según cómo distribuya su contenido Flash, el componente de Analytics para Flash se comunica con los servidores de Analytics, ya sea al conectar la comunicación entre el contenido Flash en una instalación de seguimiento de Analytics existente o al comunicarse 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 puede utilizar un modo de depuración para solucionar problemas o validar su seguimiento.

En cualquier modo, allowscriptaccess debe ser igual a always para que el seguimiento de la campaña funcione. Este parámetro activa el acceso de lectura a la URL de la página y 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 con facilidad. Aún proporciona la mayoría de los datos de actividad del usuario, pero no confirmarán el modelo de atribución de la campaña de Google Analytics.

Modo puente

Utiliza este modo si controlas la página HTML y el contenido Flash. Este modo es adecuado si ya implementó el seguimiento de Google Analytics (ga.js) en su sitio web y desea agregar el seguimiento al contenido Flash incorporado. El modo puente simplifica la comunicación de Flash a JavaScript, ya que proporciona una interfaz unificada de ActionScript 3 para el código ga.js. Proporciona la conexión de las llamadas de ActionScript 3 al JavaScript de Analytics para que el seguimiento funcione.

La conexión con el código de seguimiento de Google Analytics se puede configurar mediante el 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 su página con su propio nombre, como pageTracker. En este caso, se proporciona la referencia completa de 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 ilustra cómo se configuraría mediante el entorno de Adobe Flex con ActionScript 3: 
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • Método alternativo. Si no creó un objeto de seguimiento de página en su página, simplemente puede pasar su ID de propiedad web y se creará un objeto de código de seguimiento de JavaScript. Con este método, se requiere que hagas referencia a tu archivo base ga.js de JavaScript en tu página HTML. En el siguiente fragmento de código, se muestra cómo se configuraría esto mediante el entorno de Adobe Flex con ActionScript 3: 
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

Para que el modo puente funcione correctamente, ExternalInterface.available debe establecerse como verdadero en tu código de ActionScript 3. Esto también significa que allowScriptAccess debe establecerse como always en la página HTML que incorpora el contenido Flash. En el siguiente ejemplo, se ilustra 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>

 

Modo AS3

Utiliza este modo si controlas el código de Adobe Flash ActionScript 3, pero no controlas el entorno de alojamiento de tu aplicación de Adobe Flash. Por ejemplo, si desarrolla contenido Flash para la distribución en muchos sitios, debe usar 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 instalar ga.js de seguimiento por separado con este modo. Además, el modo AS3 utiliza el mecanismo de almacenamiento Flash para realizar un 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 los valores no están presentes, el componente usa el valor equivalente de Flash o es no de forma predeterminada.

Solución de problemas y validación

El componente de seguimiento de Google Analytics para Adobe Flash proporciona un modo de depuración para simplificar la validación y la solución de problemas. Cuando está habilitado, todos los datos de seguimiento se interceptan y dirigen a una pantalla en un cuadro de texto en lugar de los servidores de Analytics. En este modo, puede 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. Puedes habilitar la función de solución de problemas si configuras la opción visualDebug como true en el inspector de componentes.

Ejemplos

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

Flash

Flexible

Control de versiones

Puede encontrar la versión más reciente de los componentes de seguimiento como un archivo ZIP en http://code.google.com/p/gaforflash/downloads/list. Cada descarga contiene todos los componentes de seguimiento junto con 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);