本文說明如何開始使用適用於 Android v3 的 Google Analytics (分析) SDK。
事前準備
導入 SDK 之前，請確認您已備妥：
- Android 開發人員 SDK (適用於 Windows、Mac OS X 和 Linux)
- Android 專用 Google Analytics (分析) SDK v3 (
libGoogleAnalyticsServices.jar包含在專案</br>/libs目錄和建構路徑) - 可用來導入 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>
Lint 檢查工具可能會針對追蹤 ID 中使用數字破折號 ('-') 發出警告。您可以在 <resources> 標記中加入額外屬性，藉此隱藏這則警告：
<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="TypographyDashes">
如需可用於設定導入的完整參數清單，請參閱 analytics.xml 參數參考資料。視應用程式的需求而定，您可能需要變更分派週期，以驗證已正確傳送命中。舉例來說，如果您想查看即時資料，建議您將這個值設為低值 (例如 5 秒)。
恭喜！您的應用程式現已設定將資料傳送至 Google Analytics (分析)。
後續步驟
您可以運用 Google Analytics (分析) 執行更多工作，包括評估廣告活動、應用程式內付款和交易，以及使用者互動事件。
以下開發人員指南詳細說明如何在應用程式中導入 Google Analytics (分析) 功能：