Google Analytics for Android (1) - 入門

Google Analytics

使用 Google Analytics SDK 能測量什麼：

有多少活躍的使用者在使用應用程式
應用程式在什麼地點被使用
哪些特定的功能被採納及使用
應用程式發生的崩潰及例外
程式內購買(In-app purchases)和交易
其他有用的度量值

入門

在開始之前，請確認：

已安裝 Android developer SDK
已下載 Google Analytics SDK for Android v2 並將 libGoogleAnalyticsV2.jar 加入專案的 /libs 目錄。
一個新的 Google Analytics app property and profile (概略說明如下)

如果你之前已經用過 Google Analytics ，直接點選導覽列右邊的 Admin，選擇帳號(應該只會有一個)，點擊「+ New Property (web or app)」按鈕，輸入 App 名稱及類別，時區選「Taiwan」，最後按下「Get Tracking ID」就完成。這個 Property 是可以跨平台共用的，也就是說，如果你的 App 有 Android 及 iPhone 兩個版本，你不需要再新建 Property，只要一個就可以了。

怎麼做

使用 Google Analytics 的三個步驟：

修改 AndroidManifest.xml
在程式中加入 EasyTracker
建立你的 analytics.xml 檔

1. 修改 AndroidManifest.xml

加入

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. 在程式中加入 EasyTracker

在每個 Activity 的 onStart() 及 onStop() 加入如下方法：

@Override
public void onStart() {
  super.onStart();
  //...你自己的 onStart() 程式碼寫在這
  //最後再加入下面這行
  EasyTracker.getInstance().activityStart(this);
}

@Override
public void onStop() {
  super.onStop();
  //...你自己的 onStop() 程式碼寫在這
  //最後加入下面這行
  EasyTracker.getInstance().activityStop(this);
}

在呼叫 EasyTracker 的方法之前，必須傳入 Context ，例如上面這個例子中的 this。假如需要讓 EasyTracker 呼叫其他類別或方法時，必須先呼叫 setContext(Context ctx)，指定 Context 給 EasyTracker。

3. 建立你的 analytics.xml 檔

Analytics 的組態選項(configuration options)由一個 analytics.xml 資源檔來管理。你必須在 res/values 目錄中建立它，並且加入你的 tracking ID (即 Google Analytics 網站中建立 Property 時給的 Property ID：UA-XXXX-Y)。 analytics.xml 內容範例：

<?xml version="1.0" encoding="utf-8" ?>
<resources 
  xmlns:tools="https://schemas.android.com/tools" 
  tools:ignore="TypographyDashes">
 <!--把值換成你的 tracking ID-->
 <string name="ga_trackingId">UA-XXXX-Y</string>

 <!--啟動自動Activity追蹤-->
 <bool name="ga_autoActivityTracking">true</bool>

 <!--啟動自動例外追蹤-->
 <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

更多的參數可以參考 analytics.xml parameters reference。

大功告成！！現在你的 app 會傳資料給 Google Analytics 了。

參考資料：