Adobe Flex 设置

本文档包含您针对 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 文件作为项目资源,然后才能开始在项目中使用跟踪代码。

  1. 依次选择 Project->Properties。系统会显示项目的“属性”对话框。
  2. 点击 Flex Build Path,然后选择 Library Path 标签页。
  3. Library Path 窗格中,点击 Add SWC...。系统会显示“Add SWC”(添加 SWC)对话框。
  4. 转到您解压缩 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(分析)帐号中的正确数据视图(配置文件)。
  • 跟踪模式。有效参数为 BridgeAS3
  • 调试模式。将 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>