Adobe Flash 設定

本文件涵蓋為 Adobe Flash 開發環境設定 Google Analytics (分析) 追蹤功能的須知事項。

取得元件檔案

Flash 追蹤元件檔案會壓縮成一個 ZIP 檔案，您可以從 http://code.google.com/p/gaforflash/downloads/list 下載取得。

按照 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 (分析) 元件是完整的追蹤套件。只要將元件直接拖曳到階段，然後在元件檢查器中完成幾項簡單的設定，就可以開始使用 Analytics (分析) 追蹤功能來標記控制項。

AnalyticsLibrary 元件。如果您熟悉 ActionScript 3，可以使用 AnalyticLibrary 元件。將元件拖曳至您的 Flash 程式庫，並將追蹤類別直接匯入至 ActionScript 程式碼中。

使用 Analytics (分析) 元件

使用 analytics_flash.swc，透過 Analytics (分析) 元件導入追蹤功能。將元件放在正確的「元件」目錄，然後顯示在「元件」面板中 (「視窗 - 元件」)。

1. 將元件拖曳至舞台，並在「Properties」對話方塊中為該元件指定執行個體名稱。
2. 在「元件檢查器」面板中設定元件 (Windows - 元件檢查器)：
   • 加入 Analytics (分析) 網站資源 ID。
   • 選取 Bridge 模式或 AS3 模式。
   • 指出視覺偵錯功能是否開啟。
3. 在 ActionScript 程式碼中，將標準 Google Analytics (分析) 追蹤呼叫加到您剛建立的元件例項中。

受到 Flash 如何與視覺元件搭配運作，通常最好的方法就是開始追蹤 Flash 應用程式的第二個頁框。如果您需要在第一個頁框中初始化追蹤，請將追蹤呼叫放入事件處理常式內，確保元件在 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 內容活動的專屬字串，可用於追蹤 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");
} 

返回開頭