本文說明如何開始使用 Android 第 3 版 Google Analytics (分析) SDK。
事前準備
導入 SDK 前,請確認您具備:
- Android 開發人員 SDK (適用於 Windows、Mac OS X 和 Linux)
- Android 專用的 Google Analytics SDK v3 (已納入專案的
/libs
目錄和建構路徑中的libGoogleAnalyticsServices.jar
) - 可用來導入 Google Analytics (分析) 的 Android 應用程式
- 從應用程式傳送資料的至少一個 Google Analytics (分析) 資源和應用程式資料檢視 (設定檔)
入門課程
開始使用 SDK 有三個步驟:
完成這些步驟後,您就能使用 Google Analytics (分析) 評估下列項目:
- 應用程式安裝
- 活躍使用者和客層
- 畫面和使用者參與度
- 當機與例外狀況
1. 更新 AndroidManifest.xml
新增下列權限以更新 AndroidManifest.xml
檔案:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
2. 新增 EasyTracker 方法
將傳送方法新增至各個 Activities
的 onStart()
和 onStop()
方法,如以下範例所示:
package com.example.app; import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; /** * An example Activity using Google Analytics and EasyTracker. */ public class myTrackedActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); } @Override public void onStart() { super.onStart(); ... // The rest of your onStart() code. EasyTracker.getInstance(this).activityStart(this); // Add this method. } @Override public void onStop() { super.onStop(); ... // The rest of your onStop() code. EasyTracker.getInstance(this).activityStop(this); // Add this method. } }
3. 建立 analytics.xml 檔案
使用 EasyTracker 時,系統會使用 XML 中定義的資源管理全域設定。在專案的 res/values
目錄中建立名為 analytics.xml
的檔案,並新增下列資源:
<?xml version="1.0" encoding="utf-8" ?> <resources> <!--Replace placeholder ID with your tracking ID--> <string name="ga_trackingId">UA-XXXX-Y</string> <!--Enable automatic activity tracking--> <bool name="ga_autoActivityTracking">true</bool> <!--Enable automatic exception tracking--> <bool name="ga_reportUncaughtExceptions">true</bool> </resources>
針對追蹤 ID 中使用數字破折號 (「-」),Lint 檢查工具可能會發出警告。您可以在 <resources>
標記中加入其他屬性,隱藏這則警告:
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
如需可用於設定實作的參數完整清單,請參閱 analytics.xml 參數參考資料。視應用程式需求而定,建議您變更調派週期,驗證是否能正確傳送命中資料。舉例來說,如要查看即時資料,建議您將該值設為較低的值,例如 5s。
恭喜!應用程式現已設為將資料傳送至 Google Analytics (分析)。
後續步驟
Google Analytics (分析) 還有許多好處,包括評估廣告活動、應用程式內付款和交易,以及使用者互動事件。
如要進一步瞭解如何在應用程式中導入 Google Analytics (分析) 功能,請參閱下列開發人員指南:
- 評估事件:瞭解如何使用「事件」評估使用者與互動式內容 (例如按鈕、影片和其他媒體) 的互動情形。
- 評估應用程式內付款功能:瞭解如何評估應用程式內付款和交易。
- 「評估廣告活動」:瞭解如何導入廣告活動評估功能,瞭解哪些管道和廣告活動能夠提升應用程式安裝量。
- 使用者時間:瞭解如何評估應用程式中的使用者時間,進而評估載入時間、與媒體的互動情形等等。
- 「Advanced Configuration」:進一步瞭解進階設定選項,包括使用多個追蹤器。
-
Analytics.xml 參數 – 請參閱
analytics.xml
設定參數的完整清單。