Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

開始使用 Google Analytics

本快速入門向您展示如何將 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. 使用Firebase Android BoM在您的模塊(應用級)Gradle 文件(通常是app/build.gradle )中聲明 Analytics Android 庫的依賴app/build.gradle

    爪哇

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

    科特林+KTX

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

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

    爪哇

    private FirebaseAnalytics mFirebaseAnalytics;

    科特林+KTX

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

    爪哇

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

    科特林+KTX

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

開始記錄事件

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

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

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

爪哇

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

科特林+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 中顯示您的事件,幫助您立即驗證是否正在發送事件。

下一步