Adobe Flash 的 Google Analytics (分析) 追蹤功能

您可以使用 Google Analytics (分析) 追蹤 Adobe Flash 元件,輕鬆地在 Flash 導向的內容中導入 Google Analytics (分析)。此元件是由 Adobe Systems, Inc. 開發,內含 Google Analytics JavaScript 程式碼的所有功能。Flash 追蹤元件是經過編譯的追蹤物件,原生至 ActionScript 3,方便您在 Flash 和 Flex 開發環境中導入 Analytics (分析)。

為什麼要使用 Flash 追蹤?

少了 Google Analytics (分析) 追蹤 Adobe Flash 元件,否則透過 Google Analytics (分析) 追蹤 Adobe Flash 內容時,可能會遇到許多技術障礙。首先,您必須開發 ga.js 的自訂介面,才能讓 Flash 應用程式執行適當的 Analytics (分析) 方法,例如 trackPageview()trackEvent()。此外,您也必須預期 Flash 內容是否可存取瀏覽器文件物件模型 (DOM),因為當存取 DOM 時遭拒的物件 (通常是您的內容位於第三方網站時),其追蹤功能會失敗。這包括瞭解如何在 ActionScript 3 中使用 ExternalInterface 呼叫來存取瀏覽器的 DOM,以及在存取遭拒時降低效能。

適用於 Adobe Flash 檔案的 Google Analytics (分析) 元件可簡化追蹤 Flash 內容的方式,並妥善處理 DOM 存取。這項功能適用於多種 Flash 的常見追蹤用途,例如:

  • HTML 網頁中嵌入的 Flash 小工具
  • 獨立式 Flex 應用程式,或是由 HTML 網頁代管且僅由 Flash 構成的網站
  • 已發佈的 Flex/Flash 遊戲或程式,且開發人員無法控管此小工具的發佈位置

請注意,在 Flash 中追蹤應用程式會有一些結構變化,與追蹤網頁會有些許差異。要瞭解這個外掛程式的運作方式,就必須熟悉 Analytics (分析) 追蹤功能。您也可以查看這項專案的設計說明文件,進一步瞭解系統如何移植這個元件的 Analytics (分析) 追蹤模型。

注意:目前 Flash 追蹤功能適用於網頁內嵌的任何 Flash 內容。目前不支援追蹤從 Adobe Air、Shockwave 或 Flash IDE (例如使用 Test Movie) 傳送的資料。

支援的開發環境

您可以在 Adobe Flash 或 Adobe Flex 環境中開發 Flash 的 Analytics (分析) 追蹤功能。每個環境都需要不同的元件,可從 http://code.google.com/p/gaforflash/ 下載。這些元件是以 ActionScript 3 為基礎,可在每個環境透過下列其中一種方式進行設定:

在 Adobe Flash 中

  • 在元件檢查器中新增及設定簡易元件,然後拖曳至階段。
  • 直接將 Flash 追蹤程式庫匯入程式庫,開始編寫程式碼。

在 Adobe Flex 中

  • 加入您從 MXML 檔案設定的 MXML 元件。
  • 將 Flash 追蹤程式庫匯入指令碼代碼/AS3 檔案。

這個元件如何運作?

如要在您的環境中使用 Flash 追蹤元件,您可以在 Flash 中使用視覺工具,或是直接在程式碼中設定追蹤物件。無論是以視覺化方式或程式碼進行設定,您都能提供下列元素:

  • 網站資源編號:又稱為追蹤程式碼的「通用 Analytics (分析) 編號」,看起來就像 UA-xxxxx-yy,其中 x 和 y 會換成與您帳戶對應的號碼,以及所追蹤物件資料檢視 (設定檔) 的資訊。詳情請參閱網站資源
  • 追蹤模式:選擇「橋接模式」或「AS3 模式」。這個模式會決定您的追蹤功能與 Analytics (分析) 伺服器之間的通訊方式,詳細說明如下。
  • 偵錯模式:無論您使用哪一種環境或追蹤模式,都可以開啟偵錯功能來驗證和測試追蹤。

追蹤模式

視您發行 Flash 內容的方式而定,Analytics (分析) for Flash 元件會與 Analytics (分析) 伺服器進行通訊,方法包括在目前安裝的 Analytics (分析) 追蹤中合併 Flash 內容之間的通訊,或是直接與 Analytics (分析) 伺服器通訊。這兩種模式分別稱為「橋接模式」和「AS3 模式」。這兩種模式都使用相同的 Analytics (分析) 追蹤功能,您也可以輕鬆地切換不同的 Flash 應用程式模式。除了選擇 Analytics (分析) 追蹤的通訊模式,您也可以使用偵錯模式來疑難排解或驗證追蹤。

在任一模式中,allowscriptaccess 都必須等於 always,廣告活動追蹤功能才能正常運作。這個參數可讓使用者讀取網頁網址和 Flash 追蹤程式碼所需的參照網址資訊。沒有 allowscriptaccess,Analytics (分析) 追蹤程式碼會優雅降級。該轉換資料仍會提供大多數使用者活動資料,但不會對 Google Analytics (分析) 廣告活動歸因模式進行確認。

橋接模式

如果您同時控制 HTML 網頁和 Flash 內容,請使用這種模式。如果您已在網站上導入 Google Analytics (分析) (ga.js) 追蹤功能,而且想要在內嵌的 Flash 內容中加入追蹤功能,就非常適合使用這個模式。橋接模式會為 ga.js 程式碼提供統合的 ActionScript 3 介面,藉此簡化 Flash 對 JavaScript 的通訊。它提供 ActionScript 3 呼叫與 Analytics (分析) JavaScript 的連線,以便讓追蹤功能正常運作。

透過網站資源 ID 參數,您可以透過下列其中一種方式設定 Google Analytics (分析) 追蹤程式碼連結:

  • 最常見的方法。網頁上已有 Google Analytics (分析) 追蹤程式碼物件擁有自己的名稱,例如 pageTracker。 在這種情況下,請提供追蹤物件的完整 DOM 參照。例如,如果物件的名稱是 pageTracker,您可以在程式碼中將該物件參照為 window.pageTracker。例如,下列程式碼片段說明如何透過 Adobe Flex 環境搭配 ActionScript 3 進行設定:
    tracker = new GATracker( this, "window.pageTracker", "Bridge", false );

  • 替代方法:如果您尚未在網頁上建立網頁追蹤物件,只要傳入網站資源編號,系統就會自動建立 JavaScript 追蹤程式碼物件。使用此方法時,您的 HTML 網頁仍需參照基本 ga.js JavaScript 來源檔案。以下程式碼片段說明如何透過 ActionScript 3 使用 Adobe Flex 環境進行設定:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

為了讓橋接模式正常運作,您必須在 ActionScript 3 程式碼中將 ExternalInterface.available 設為 true。也就是說,在嵌入 Flash 內容的 HTML 網頁中,allowScriptAccess 必須設為 always。以下範例說明為橋接模式設定的 HTML 程式碼:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

 

AS3 模式

如果控制 Adobe Flash ActionScript 3 程式碼,就不能控制 Adobe Flash 應用程式的代管環境,請使用此模式。舉例來說,如果您要開發透過多個網站發布的 Flash 內容,可以使用 AS3 模式。AS3 模式與 ga.js 追蹤程式碼完全無關,且包含所有 Analytics (分析) 追蹤功能。使用這個模式時,您不需要另外安裝 ga.js 追蹤安裝。此外,AS3 模式也使用 Flash 儲存機制追蹤使用者的工作階段資訊。

對於語言等特定的 DOM 參數,AS3 元件會嘗試從瀏覽器擷取值。如果沒有這些值,元件會使用 Flash 對應的值或預設為 no

疑難排解和驗證

Adobe Flash 的 Google Analytics (分析) 追蹤功能提供偵錯模式,可簡化驗證流程和疑難排解流程。啟用後,系統會攔截所有追蹤資料,然後導向至文字方塊,而不是 Analytics (分析) 伺服器。在這個模式中,您可以查看伺服器可能收集的即時資料。這項功能也有助於將測試資料傳送至正式環境資料以外的位置。如要啟用疑難排解功能,您可以在元件檢查器中將 visualDebug 選項設為 true

示例

如需在不同開發環境中導入追蹤的詳細範例,請參閱下列文章:

閃光燈

Flex

版本管理

您可以前往 http://code.google.com/p/gaforflash/downloads/list 取得最新版追蹤元件的 ZIP 檔案。每次下載都包含所有追蹤元件以及相關說明文件。下載檔案的檔案名稱會顯示所含程式碼的版本編號。

您也可以在程式碼中使用下列陳述式,在輸出主控台中列印元件的目前版本號碼。

import com.google.analytics.API;
trace(API.version);