本文档包含您针对 Adobe Flex 开发环境设置适用于 Adobe Flash 的 Google Analytics(分析)跟踪需要了解的所有内容。
获取跟踪库
从 http://code.google.com/p/gaforflash/downloads/list 下载代码(ZIP 格式)。按照 readme.txt
文件中的说明安装 Flex 组件。与 Analytics Flash 组件不同,下载内容中只有一个库文件:/lib/analytics_flex.swc
。
将代码添加到项目中
在项目中开始使用跟踪代码之前,您需要关联下载的 SWC
文件作为项目资源。
- 选择 Project->Properties。系统会显示项目的“属性”对话框。
- 点击 Flex Build Path,然后选择 Library Path 标签页。
- 点击 Library Path 窗格中的 Add SWC...。系统会显示 Add SWC(添加 SWC)对话框。
- 导航到 Google Analytics(分析)API 解压缩到的位置,选择
lib/analytics.swc
文件,然后点击 OK。
或者,只需将analytics.swc
文件拖放到 Flex 项目/libs
目录中。
Flex MXML 组件示例
下面的示例显示了如何在 MXML 文件中为按钮设置跟踪。要初始化 MXML 组件,请执行以下操作:
- 设置 XML 命名空间参数。按如下方式设置跟踪对象的 XML 命名空间参数:
xmlns:analytics="com.google.analytics.components.*"
- 设置对象名称。在下面的示例中,
id
参数设置为tracker
。 - 使用
account
参数作为网络媒体资源 ID。网络媒体资源 ID 是用来跟踪 Flash 内容的活动,并将其发送到 Google Analytics(分析)帐号中的正确数据视图(配置文件)的唯一字符串。 - 使用
mode
参数设置跟踪模式。如果您要创建一个 MXML 文件并希望以一种简单的方式实施跟踪,请为该参数使用Bridge
。如果您习惯使用 Action3 进行编码,请使用AS3
。在 AS3 模式下,您可以导入所有 GA 跟踪类,并可以使用这些类创建和配置自己的跟踪对象。 - 使用
visualDebug
参数设置调试模式。请使用true
打开程序的调试和验证功能;否则,请将其设置为false
以用于生产环境。
在此示例中,向场景中添加了一个按钮 mybutton
。Flex 跟踪组件使用名称 tracker
进行实例化,并使用其参数进行配置。最后,onButtonClick
添加了一个点击事件 mybutton
。点击该按钮后,虚拟网页浏览量 /hello world
会增加一次。
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" > <mx:Script> public function onButtonClick():void { tracker.trackPageview( "/hello world" ); } </mx:Script> <analytics:FlexTracker xmlns:analytics="com.google.analytics.components.*" id="tracker" account="UA-111-222" mode="AS3" visualDebug="false" /> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>
Flex ActionScript 3 示例
在更复杂的情况下,您可能希望直接从 ActionScript 资源文件调用本地 ActionScript 3 跟踪类。虽然此示例也是一个 MXML 文件,但所有跟踪实例化都是在 <MX:script>
标记中完成的。上述流程同样可用于向其他 ActionScript 3 项目添加跟踪功能。
在此示例中,向场景中添加了一个按钮 mybutton
。在脚本标记中,导入了两个库:
com.google.analytics.GATracker; //this is the actual tracking class com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements
导入库后,创建了跟踪变量 tracker
。将该应用添加到 Stage 之后,调用 onComplete
以实例化跟踪对象。创建 GATracker 对象实例所需的四个参数为:
- 引用当前的展示对象。在以下示例中,
this
引用了显示对象。 - 网络媒体资源 ID。网络媒体资源 ID 是用来跟踪 Flash 内容的活动,并将其发送到 Google Analytics(分析)帐号中的正确数据视图(配置文件)的唯一字符串。
- 跟踪模式。有效参数为
Bridge
或AS3
。 - 调试模式。将
debug
设置为false
以供生产环境使用,设置为true
以进行验证和问题排查。
最后,在 myButton
点击方法中,onButtonClick
函数会跟踪跟踪对象的虚拟网页浏览。
此应用程序运行时,每当用户点击此按钮,就会向 Google Analytics(分析)跟踪服务器发送“hello world”的虚拟浏览量。
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" addedToStage="onComplete()" > <mx:Script> <![CDATA[ import com.google.analytics.GATracker; import com.google.analytics.AnalyticsTracker; public var tracker:AnalyticsTracker; private function onComplete():void { tracker = new GATracker( this, "UA-111-222", "AS3", false ); } public function onButtonClick():void { tracker.trackPageview( "/hello/world" ); } ]]> </mx:Script> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>