本文档包含您针对 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
。如果您习惯使用 ActionScript3 进行编码,请使用AS3
。在 AS3 模式下,您可以导入所有 Google Analytics(分析)跟踪类,从而通过该类来创建和配置自己的跟踪对象。 - 使用
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
。将应用添加到界面后,系统将调用 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>