Android v2 專用的 Google Analytics (分析) SDK - 總覽

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

簡介

Android 專用的 Google Analytics (分析) SDK 可讓開發人員輕鬆從自家應用程式收集使用者參與度資料。這樣一來，開發人員就可以使用 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 檔案

在 Android 專用的 Google Analytics (分析) SDK 2 版中，設定選項是透過本指南中名為 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 (分析) 執行更多功能，包括評估廣告活動、應用程式內付款和交易，以及使用者互動事件。請參閱下列開發人員指南，瞭解如何將這些功能新增至實作項目：

  • 「Advanced Configuration」：進一步瞭解進階設定選項，包括使用多個追蹤器。
  • 評估廣告活動：瞭解如何執行廣告活動評估，瞭解哪些管道和廣告活動能夠提高應用程式安裝量。
  • 評估事件：瞭解如何使用「事件」功能評估互動式內容 (例如按鈕、影片和其他媒體) 的使用者參與度。
  • 評估應用程式應用程式內付款：瞭解如何評估應用程式內付款和交易。
  • 使用者時間：瞭解如何評估應用程式中的使用者時間，以評估載入時間、與媒體互動等。
  • Analytics.xml 參數：查看 analytics.xml 設定參數的完整清單。