本文件說明舊版 Android SDK。如果您是第一次使用 Analyitcs，請使用最新的 SDK。瞭解詳情

Google Analytics SDK for Android v2 (舊版) - 總覽

Android 版 Google Analytics (分析) SDK 可讓開發人員輕鬆透過應用程式收集使用者參與度資料。本文件將概略介紹 SDK 的價值，並介紹如何使用單一資源 ID 和 EasyTracker 來評估應用程式。

引言

Google Analytics (分析) SDK for Android 可讓開發人員輕鬆從應用程式收集使用者參與度資料。開發人員可使用 Google Analytics (分析) 報表來評估：

  • 活躍使用者使用應用程式的人數。
  • 從世界各地使用應用程式。
  • 採用和使用特定功能。
  • 應用程式內購和交易。
  • 應用程式當機的次數和類型。
  • 以及許多其他實用指標。

此外，Android 專用的 Google Analytics (分析) SDK 提供各項工具，協助您監控行銷管道的成效，包括監控 Google Play 安裝項目、應用程式內購次數和交易次數等，方便您監控行動行銷廣告活動的成效。

事前準備

開始導入 SDK 之前，請確認您已備妥：

開始使用

開始使用 SDK 有以下三個步驟：

  1. 更新 AndroidManifest.xml
  2. 新增 EasyTracker 方法
  3. 建立 analytics.xml 檔案

完成這些步驟後，您就能使用 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() 方法，如以下範例所示：

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
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().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

請注意，EasyTracker 需要 Context，才能呼叫其方法。在上述範例中，此行：

EasyTracker.getInstance.activityStart(this);

會負責設定結構定義。不過，如果您需要在其他類別或方法中呼叫 EasyTracker 呼叫，則必須先呼叫 EasyTracker' 的 setContext(Context ctx) 方法：

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. 建立 analytics.xml 檔案

在第 2 版 Google Analytics (分析) SDK 版本中，設定選項是由名為 analytics.xml 的 XML 資源檔案管理。您必須在專案的res/values目錄中建立這個檔案，並新增追蹤 ID。以下範例說明如何新增追蹤 ID，並啟用 Activity 和例外狀況評估：

<?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 參數參考資料。

恭喜！您的應用程式現已設定將資料傳送至 Google Analytics (分析)。

後續步驟

您可以運用 Google Analytics (分析) 執行更多工作，包括評估廣告活動、應用程式內付款和交易，以及使用者互動事件。請參閱下列開發人員指南，瞭解如何將這些功能新增至實作項目：

  • 進階設定：進一步瞭解進階設定選項，包括使用多個追蹤器。
  • 評估廣告活動：瞭解如何導入廣告活動評估功能，瞭解哪些管道和廣告活動可促成應用程式安裝。
  • 評估事件：瞭解如何使用事件等互動式內容來評估使用者參與度。
  • 評估應用程式內付款：瞭解如何評估應用程式內付款和交易。
  • 使用者載入時間：瞭解如何評估應用程式中的使用者時間，以評估載入時間、與媒體的互動等等。
  • Analytics.xml 參數：請參閱 analytics.xml 設定參數的完整清單。