本遷移指南將說明 SDK 第 2 版的新功能,為開發人員提供從 v1.x 實作項目遷移的提示。如果開發人員不必從 v1.x 實作項目中遷出,請立即開始使用第 2 版。
簡介
Google Analytics (分析) 最近發布了 Android 2 適用的新版 Google Analytics (分析) SDK。SDK 第 2 版提供了新功能支援,以及專為應用程式開發人員設計的新版報表介面。
我們建議所有現有的 Google Analytics (分析) 開發人員都遷移至 Android 專用 Google Analytics (分析) SDK 2 版,以便使用新的功能和報表。
第 2 版的新功能
Android 專用的 Google Analytics (分析) SDK 版本推出了專為應用程式開發人員設計的全新報表體驗,以及強大的全新維度和指標等等。以下是開發人員在第 2 版享有的內容:
- 為應用程式開發人員提供更強大的報表
- 標準報表專為應用程式開發人員重新設計,加入了「參與流程」和「Google Play 來源」等新報表,可協助開發人員深入瞭解使用者開發和體驗。請參閱我們的 帳戶設定最佳做法,進一步瞭解為版本 2 設定資源的最佳做法。
- 新的應用程式維度和指標
- Google 在第 2 版中導入了新的應用程式專屬維度和指標,包括畫面名稱、畫面瀏覽、應用程式名稱和應用程式版本等。
- 評估當機和例外狀況
- Android 適用的 Google Analytics (分析) SDK 推出了例外狀況評估和例外狀況命中類型。藉由例外狀況評估,您可以評估當機與一般例外狀況的數量和類型。如要瞭解如何實作例外狀況評估,請參閱「例外狀況開發人員指南」。
- 自訂維度和指標
- 建立自訂維度,以新的方式區隔資料。 進一步瞭解自訂維度和指標。
- 評估社交互動
- 評估使用者與嵌入式社交外掛程式和小工具的互動情形,深入瞭解應用程式中的社交價值。 進一步瞭解如何評估社交互動。
事前準備
所有開發人員都希望在開始遷移前,先採取以下兩個步驟:
- 下載 Android 專用的 Google Analytics (分析) SDK 第 2 版
- 建立應用程式資料檢視 (設定檔),方便您存取新的應用程式報表和資料。
完成上述步驟後,請根據您的遷移路徑執行下列步驟。
從 EasyTracker 遷移
您需要採取三個步驟,將應用程式從 EasyTracker 程式庫第 1 版遷移至第 2 版:
1. 更新 GoogleAnalytics.xml 中的參數
遷移至第 2 版時,請更新 GoogleAnalytics.xml 資源檔案中的參數,因為某些參數自 v1.x 起已變更,且在版本 2 中新增了參數。
下表列出在第 2 版中更新的參數:
v1.x 參數名稱 | v2.x 參數名稱 |
---|---|
ga_api_key | ga_trackingId |
ga_auto_activity_tracking | ga_autoActivityTracking |
ga_dryRun | 已淘汰 |
詳情請參閱 新版和更新的 EasyTracker 參數。
2. 更新方法名稱
雖然 EasyTracker 第 2 版中的許多語法都相同,但方法名稱和語法仍有一些明顯差異,因此需要您更新實作:
- 在第 2 版中,
trackPageView()
是sendView()
。詳情請參閱螢幕追蹤開發人員指南。 - 電子商務導入作業已經簡化。瞭解如何在第 2 版中導入電子商務評估。
- 自訂變數已由「自訂維度」和「指標」取代。所有對
setCustomVar()
的呼叫都應更新,以便充分運用新功能。 瞭解如何導入自訂維度和指標。
3. 更新廣播接收器 (Google Play 廣告活動追蹤)
使用 v1.x 導入 Google Play 廣告活動追蹤的開發人員應留意,接收器的類別路徑已變更。詳情請參閱 Google Play 廣告活動追蹤指南。
從自訂導入遷移
如果您未在 Android 專用 Analytics (分析) SDK v1.x 中使用 EasyTracker 程式庫,建議您開始在第 2 版中使用 EasyTracker。
SDK 現已納入 EasyTracker 程式庫,建議所有開發人員使用。 開始使用 Google Analytics (分析) SDK 第 2 版中的 EasyTracker。
如果您有進階資料收集需求 (例如在單一導入作業中使用多個屬性 ID),請參閱進階設定指南,進一步瞭解如何使用 SDK v2.x 的進階功能。