開始使用 Google Analytics (分析)

本快速入門導覽課程說明如何將 Google Analytics (分析) 新增至您的應用程式,並開始記錄事件。

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

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

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

事前準備

如果您尚未將 Firebase 新增至 Android 專案,並確認已在您的 Firebase 專案中啟用 Google Analytics (分析),請先完成這項作業:

  • 如要建立新的 Firebase 專案,請在專案建立工作流程中啟用 Google Analytics (分析)。

  • 如果您使用的是現有的 Firebase 專案,但尚未啟用 Google Analytics (分析),請依序前往 >「Project settings」(專案設定) 的「Integrations」(整合) 分頁來啟用專案。

在專案中啟用 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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. 請在 onCreate() 方法中初始化這個變數:

    Kotlin+KTX

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

    Java

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

開始記錄事件

建立 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")
}

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);

您可以啟用詳細記錄功能來監控 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 中顯示事件,協助您立即驗證事件是否正在傳送。

後續步驟