開始使用 Google Analytics

本快速入門導覽課程將說明如何將 Google Analytics 新增到您的應用程式 開始記錄事件。

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

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

Analytics 會自動記錄 事件和 使用者屬性； 不需要新增任何程式碼

事前準備

如果您尚未將 Firebase 新增至 Android，請先完成這項操作。 專案，並確認 Google Analytics 已在 Firebase 專案中啟用：

  • 如要建立新的 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.1.2"))

    // 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 程式庫版本。

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

    如果選擇不使用 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.0.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 中顯示事件，協助您 立即確認事件是否正在傳送。

後續步驟