開始使用 Google 分析

本快速入門向您展示如何將 Google Analytics 添加到您的應用程序並開始記錄事件。

Google Analytics 收集您應用程序的使用情況和行為數據。 SDK 記錄兩種主要類型的信息：

事件：您的應用程序中發生的事情，例如用戶操作、系統事件或錯誤。
用戶屬性：您定義的用於描述用戶群細分的屬性，例如語言偏好或地理位置。

Analytics 自動記錄一些事件和用戶屬性；您無需添加任何代碼即可啟用它們。

在你開始之前

如果您還沒有，請將 Firebase 添加到您的 Android 項目並確保在您的 Firebase 項目中啟用了 Google Analytics：

如果您要創建新的 Firebase 項目，請在項目創建工作流程中啟用 Google Analytics。
如果您使用的是未啟用 Google Analytics 的現有 Firebase 項目，請轉到設置的“集成”選項卡 >項目設置啟用它。

當您在項目中啟用 Google Analytics 時，您的 Firebase 應用程序會鏈接到 Google Analytics 數據流。

將 Analytics SDK 添加到您的應用程序

在您的模塊（應用程序級）Gradle 文件（通常為<project>/<app-module>/build.gradle ）中，添加 Analytics Android 庫的依賴項。我們建議使用Firebase Android BoM來控制庫版本。

Kotlin+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.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-ktx'
}

通過使用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-ktx:21.2.0'
}

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.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 庫。

（備選）在不使用 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:21.2.0'
}

在活動頂部聲明com.google.firebase.analytics.FirebaseAnalytics對象：

Kotlin+KTX

private lateinit var firebaseAnalytics: FirebaseAnalyticsMainActivity.kt

Java

private FirebaseAnalytics mFirebaseAnalytics;MainActivity.java

在onCreate()方法中初始化它：

Kotlin+KTX

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analyticsMainActivity.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 中顯示您的事件，幫助您立即驗證是否正在發送事件。

下一步

使用DebugView驗證您的事件。
在Firebase 控制台中探索您的數據。
瀏覽有關事件和用戶屬性的指南。
了解如何將數據導出到BigQuery。