Adobe Flash 设置

本文档包含您针对 Adobe Flash 开发环境设置适用于 Adobe Flash 的 Google Analytics(分析)跟踪需要了解的所有内容。

获取组件文件

您可以从 http://code.google.com/p/gaforflash/downloads/list 下载单个 ZIP 文件,以便将 Flash 跟踪组件文件压缩成一个 ZIP 文件。

按照 readme.txt 文件中的说明安装 Flash 组件。

  1. 如果您当前已打开 Adobe Flash CS3,请退出该应用程序。
  2. 在以下任一位置创建一个 Google 目录:
    • 对于 Windows:C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
    • 对于 Mac OS X:Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
  3. 转到您解压缩组件 ZIP 文件的位置,并将以下文件复制到您在上一步中创建的目录:
    • lib/analytics_flash.swc - Analytics 组件
    • lib/analytics.swc - Analytics 库组件

这两个组件的功能相同,但它们是出于方便不同的开发样式的目的而提供的。

Analytics 组件。如果您要开发 Flash 内容,却不熟悉 ActionScript 3,请使用此组件。Analytics 组件是一个完整的跟踪包。只需直接将组件拖放到您的工作区,然后在组件检查器中进行一些简单的设置,就可以开始在控件中使用 Google Analytics(分析)跟踪标记了。

AnalyticsLibrary 组件。如果您熟悉 ActionScript 3,可以使用 AnalyticLibrary 组件。将此组件拖到 Flash 库中,并将跟踪类直接导入您的 ActionScript 代码中。

使用 Analytics 组件

使用 analytics_flash.swc,通过 Analytics 组件实现跟踪。请将该组件放置在正确的目录中,该组件会在“组件”面板(“窗口 - 组件”)中显示。

  1. 将该组件拖到场景中,然后在属性对话框中为其指定实例名称。
  2. 在“组件检查器”面板中配置该组件 (Windows - 组件检查器):
    • 添加您的 Google Analytics(分析)网络载体 ID。
    • 选择桥接模式或 AS3 模式。
    • 指示视觉调试功能处于开启还是关闭状态。
  3. 在您的 ActionScript 代码中,向您刚刚创建的组件实例中添加标准 Google Analytics(分析)跟踪调用。

考虑到 Flash 可视化组件的工作方式,您通常最好从 Flash 应用程序的第 2 帧开始跟踪。如果您需要在第一帧上初始化跟踪,请将跟踪调用置于事件处理脚本内,以确保组件在 Flash 内容中完全初始化。

简单的 Analytics Flash 组件示例

以下代码段显示有人点击了 Flash 中的按钮时,组件是如何对其进行跟踪的。在此示例中,ActionScript 中的按钮实例名为 playGame。点击该按钮时,系统会调用 onButtonClick 方法,该方法接着会调用 trackPageview() 方法。这会使虚拟网页“/myGame1”的网页浏览量递增。

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

使用 AnalyticsLibrary 组件

使用 analytics.swc 文件,通过 AnalyticsLibrary 组件实现跟踪。该组件允许您直接在 AS3 代码中实例化跟踪对象。AnalyticsLibrary 组件置于正确位置后,会显示在“组件”面板中。您可以从组件面板中将该组件拖到您的库中,并从此处将库导入您的 ActionScript 代码中。

初始化跟踪对象

在 Adobe Flash 环境中,使用以下参数初始化跟踪对象:

  • 引用当前展示对象。在下面的示例中,this 引用了展示对象。
  • 网络媒体资源 ID。网络媒体资源 ID 是一个具有唯一性的字符串,用于跟踪 Flash 内容的相关活动并将其投放到 Google Analytics(分析)帐号中的正确数据视图(配置文件)。
  • 跟踪模式。有效参数为 BridgeAS3
  • 调试模式。将 debug 设置为 false 以用于生产环境,设置为 true 以进行验证和问题排查。

简单的 AnalyticsLibrary 示例

以下示例中,工作区中存在一个名为 playGame 的电影片段。系统创建了名为 tracker 的新跟踪对象,以及监听鼠标点击的事件处理脚本。点击该按钮时,系统会调用 onButtonClick 函数。对于每次点击,trackPageview() 方法都会递增虚拟网页 /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");
}