此页面由 Cloud Translation API 翻译。

Adobe Flash 设置

本文档将介绍针对 Adobe Flash 开发环境设置适用于 Adobe Flash 的 Google Analytics（分析）跟踪需要注意的所有事项。

获取组件文件

您可从 http://code.google.com/p/gaforflash/downloads/list 下载 Flash 跟踪组件文件，压缩为单个 ZIP 文件。

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

如果您当前打开了 Adobe Flash CS3，请退出该应用。
在以下任一位置创建 Google 目录：
- 对于 Windows：C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
- 对于 Mac OS X：Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
找到解压缩组件 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 组件实现跟踪。请将该组件放置在正确的“组件”目录中，该组件目录会显示在“组件”面板中（窗口 - 组件）。

将组件拖到场景中，然后在属性对话框中为其指定一个实例名称。
在“组件检查器”面板中配置该组件 (Windows - 组件检查器)：
- 添加您的 Google Analytics（分析）网络载体 ID。
- 选择迁移桥模式或 AS3 模式。
- 指明是启用还是停用视觉调试。
在您的 ActionScript 代码中，将标准 Google Analytics（分析）跟踪调用添加到您刚创建的组件的实例中。

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

简单的 Google 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（分析）帐号中的正确数据视图（配置文件）的唯一字符串。
跟踪模式。有效参数为 Bridge 或 AS3。
调试模式。将 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");
}

返回页首