Android v3 專用的 Google Analytics (分析) SDK - 入門

本文說明如何開始使用 Android 3 專用的 Google Analytics (分析) SDK。

事前準備

導入 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() 方法，如以下範例所示：

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 (分析) 功能：

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