Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

開始使用 Google Analytics

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

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

  • 事件:什麼是發生在你的應用程序,如用戶操作,系統事件或錯誤。
  • 用戶屬性:屬性定義來描述你的用戶群的細分,如語言偏好或地理位置。

Analytics(分析)會自動記錄一些事件用戶屬性;您無需添加任何代碼即可啟用它們。

在你開始之前

如果你還沒有,添加火力地堡到您的Android項目,並確保谷歌Analytics(分析)在您的火力地堡項目啟用:

  • 如果您要創建新的 Firebase 項目,請在項目創建工作流程中啟用 Google Analytics。

  • 如果您使用的是沒有啟用谷歌分析,去到一個現有的火力地堡項目集成的標籤頁 >項目設置來啟用它。

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

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

  1. 使用火力地堡Android的物料清單,聲明你的模塊(應用程序級)搖籃文件(通常為分析的Android庫的依賴app/build.gradle )。

    爪哇

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

    通過使用火力地堡Android的物料清單,您的應用程序將始終使用火力地堡的Android庫的兼容版本。

    (替代)聲明火力地堡庫依賴使用物料清單

    如果您選擇不使用 Firebase BoM,則必須在其依賴項行中指定每個 Firebase 庫版本。

    需要注意的是,如果你在你的應用程序使用多個火力地堡庫,我們強烈建議您使用的物料清單管理庫版本,以保證所有版本相互兼容。

    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.2'
    }
    

    科特林+KTX

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

    通過使用火力地堡Android的物料清單,您的應用程序將始終使用火力地堡的Android庫的兼容版本。

    (替代)聲明火力地堡庫依賴使用物料清單

    如果您選擇不使用 Firebase BoM,則必須在其依賴項行中指定每個 Firebase 庫版本。

    需要注意的是,如果你在你的應用程序使用多個火力地堡庫,我們強烈建議您使用的物料清單管理庫版本,以保證所有版本相互兼容。

    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.2'
    }
    

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

下一步