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

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Adobe Flash 適用的 Google Analytics (分析) 追蹤元件,可讓您在 Flash 驅動的內容中輕鬆導入 Google Analytics (分析)。這個元件是由 Adobe Systems, Inc. 開發,內含 Google Analytics (分析) JavaScript 程式碼的所有功能。Flash 追蹤元件是原生於 iFrame 3 的編譯追蹤物件,可讓 Analytics (分析) 的實作項目在 Flash 和 Flex 開發環境中都相當直覺化。

使用 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 傳送的資料 (例如使用「測試電影」)。

支援的開發環境

您可以在 Adobe Flash 或 Adobe Flex 環境中開發適用於 Flash 的 Analytics (分析) 追蹤。每種環境都使用不同的元件。如要下載這個元件,請前往 http://code.google.com/p/gaforFlash/。這些元件是以 ActionScript 3 為基礎,可能為每種環境設定兩種方法:

在 Adobe Flash 中

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

在 Adobe Flex 中

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

這個元件如何運作?

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

  • 網站資源 ID - 這稱為追蹤程式碼的「UA 號碼」,看起來是 UA-xxxxx-yy,其中 x's 和 y's 會對應至您的帳戶,以及追蹤中的物件檢視 (設定檔) 資訊。詳情請參閱網站資源
  • 追蹤模式:選擇 [橋接模式] 或 [AS3 模式]。這個模式決定您的追蹤與 Analytics (分析) 伺服器進行通訊的方式,詳細說明如下。
  • 偵錯模式:無論您使用何種環境或追蹤模式,都可以開啟偵錯功能來驗證並測試追蹤結果。

追蹤模式

視您發布 Flash 內容的方式而定,Analytics (分析) for Flash 元件可透過在現有 Analytics (分析) 追蹤安裝作業中,寫入 Flash 內容之間的通訊,或直接直接與 Analytics (分析) 伺服器通訊,以傳送至 Analytics (分析) 伺服器。這兩種模式分別為「橋接模式」和「AS3 模式」。這兩種模式都使用相同的 Analytics (分析) 追蹤功能,方便您在另一種模式之間切換除了選擇 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 );

  • 替代方案。如果您尚未在網頁上建立網頁追蹤物件,只要傳入網站資源 ID,系統就會為您建立 JavaScript 追蹤程式碼物件。透過這個方法,仍需在 HTML 網頁中參照基礎 ga.js JavaScript 來源檔案。下列程式碼片段示範如何使用 Adobe Flex 環境搭配 ActionScript 3 來設定:
    tracker = new GATracker( this, "UA-12345-22", "Bridge", false );

為了讓橋接模式正常運作,您必須在 Workspace 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,即可啟用疑難排解功能。

範例

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

閃光燈

彈性

版本管理

您可以前往 http://code.google.com/p/gaforlax/downloads/list,使用 ZIP 檔案找到最新版的追蹤元件。每項下載作業都包含所有追蹤元件和相關說明文件。下載檔案的檔案名稱會顯示其版本號碼。

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

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