本文件說明舊版 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 方法

將傳送方法新增至每個 ActivitiesonStart()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 設定參數的完整清單。