開始使用 Google Analytics


本快速入門導覽課程說明如何在應用程式中加入 Google Analytics，並開始記錄事件。

Google Analytics 會收集應用程式的使用和行為資料。SDK 會記錄兩種主要類型的資訊：

  • 事件：應用程式中的活動，例如使用者動作、系統事件或錯誤。
  • 使用者屬性：您定義的屬性，用來描述使用者族群區隔，例如語言偏好或地理位置。

Analytics 會自動記錄部分事件和使用者屬性，您不需要新增任何程式碼即可啟用這些屬性。

事前準備

如果您尚未將 Firebase 新增至 Android 專案，請務必在 Firebase 專案中啟用 Google Analytics：

  • 如果您要建立新的 Firebase 專案，請在專案建立工作流程中啟用 Google Analytics。

  • 如果您使用的是現有的 Firebase 專案，但未啟用 Google Analytics，請前往 >「專案設定」 的「整合」分頁標籤 啟用。

在專案中啟用 Google Analytics 後，您的 Firebase 應用程式就會連結至 Google Analytics 資料串流。

在應用程式中加入 Analytics SDK

  1. 在模組 (應用程式層級) Gradle 檔案 (通常為 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle) 中，加入 Android 的 Analytics 程式庫依附元件。建議您使用 Firebase Android BoM 來控制程式庫版本。

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

    // Add the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics")
}

    只要使用 Firebase Android BoM，應用程式就會一律使用相容的 Firebase Android 程式庫版本。

    (替代做法)  不使用 BoM 新增 Firebase 程式庫依附元件

    如果您選擇不使用 Firebase BoM，則必須在依附元件行中指定每個 Firebase 程式庫版本。

    請注意，如果您在應用程式中使用多個 Firebase 程式庫，強烈建議您使用 BoM 來管理程式庫版本，確保所有版本皆相容。

    dependencies {
    // Add the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics:22.1.2")
}
    想找 Kotlin 專屬的程式庫模組嗎？自 2023 年 10 月 (Firebase BoM 32.5.0)起，Kotlin 和 Java 開發人員皆可依賴主要程式庫模組 (詳情請參閱這項計畫的常見問題)。

  2. 在活動頂端宣告 com.google.firebase.analytics.FirebaseAnalytics 物件：

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. 在 onCreate() 方法中初始化：

    Kotlin+KTX 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

開始記錄事件

建立 FirebaseAnalytics 例項後，您就可以開始使用 logEvent() 方法記錄事件。

有些事件適用於所有應用程式，有些則適用於特定業務類型或產業。建議您傳送包含規定參數的建議事件，這樣報表就能呈現最詳盡的資料，也方便您日後使用新推出的功能和整合服務。本節將示範如何記錄預先定義的事件。如要進一步瞭解記錄事件，請參閱「記錄事件」。

當使用者在應用程式中按一下特定元素，以下程式碼會記錄 SELECT_CONTENT 事件。

Kotlin+KTX 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Java 

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

您可以啟用詳細記錄功能，監控 SDK 記錄的事件，以便確認事件是否正確記錄。這包括自動記錄和手動記錄的事件。

您可以使用一系列 adb 指令啟用詳細記錄功能：

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

這個指令會在 Android Studio 的 Logcat 中顯示事件，協助您立即驗證事件是否已傳送。

後續步驟