Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

開始使用 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 添加到您的應用程序

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

    Java

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

    Kotlin+KTX

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

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate()方法中初始化它:

    Java

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

    Kotlin+KTX

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

開始記錄事件

創建FirebaseAnalytics實例後,您可以開始使用logEvent()方法記錄事件。

建議所有應用程序使用某些事件;其他推薦用於特定的業務類型或垂直行業。您應該發送建議的事件及其規定的參數,以確保在您的報告中提供最大的可用詳細信息,並從未來可用的功能和集成中受益。本節演示記錄預定義事件,有關記錄事件的更多信息,請參閱記錄事件

當用戶單擊應用程序中的特定元素時,以下代碼會記錄一個SELECT_CONTENT事件。

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

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

您可以啟用詳細日誌記錄以監控 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 中顯示您的事件,幫助您立即驗證是否正在發送事件。

下一步