Adobe Flex 設定

本文件涵蓋為 Adobe Flex 開發環境設定 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」對話方塊。
前往 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。
使用網站資源 ID 的 account 參數。網站資源 ID 是用來追蹤 Flash 內容活動的專屬字串，可用於追蹤 Analytics (分析) 帳戶中的正確資料檢視 (設定檔)。
使用 mode 參數設定追蹤模式。如果您建立的是 MXML 檔案，並想透過簡單的方法導入追蹤，請為參數使用 Bridge。如果您習慣使用 ActionScript3 編寫程式碼，請使用 AS3。AS3 模式可讓您匯入所有 Google Analytics (分析) 追蹤類別，再從中建立和設定自己的追蹤物件。
使用 visualDebug 參數設定偵錯模式。使用 true 開啟程式的偵錯和驗證功能；否則，請將其設定為 false，以用於實際工作環境。

在此範例中，系統會在階段中新增 mybutton 按鈕。Flex 追蹤元件是以 tracker 名稱例項化，並使用其參數進行設定。最後，在 mybutton 中新增點擊事件 onButtonClick。使用者點選按鈕時，虛擬網頁瀏覽 /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 內容活動的專屬字串，可用於追蹤 Analytics (分析) 帳戶中的正確資料檢視 (設定檔)。
追蹤模式。有效參數包括 Bridge 或 AS3。
偵錯模式。請將 debug 設為 false 來用於正式環境，設為 true 以進行驗證和疑難排解。

最後，在 myButton 點擊方法中，onButtonClick 函式會追蹤追蹤物件的虛擬網頁瀏覽。

這個應用程式執行時，只要使用者按下按鈕，系統就會將「hello world」虛擬網頁瀏覽傳送至 Google Analytics (分析) 追蹤伺服器。

<?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>

返回開頭