Adobe Flash 设置

在进行 Universal Analytics 升级的过程中，我们建议您使用此库的较新版本。了解如何升级到 Universal Analytics。

本文档包含您针对 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 组件，使用 analytics_flash.swc 实现跟踪。请将该组件放置在正确的“组件”目录中，该组件会在“组件”面板（窗口 - 组件）中显示。

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

考虑到 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（分析）帐号中的正确数据视图（配置文件）的唯一字符串。
• 跟踪模式。有效参数为 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");
} 

返回页首