Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

開始使用Google Analytics(分析)

本快速入門介紹瞭如何將Google Analytics(分析)添加到您的應用並開始記錄事件。

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

  • 事件:應用程序中發生的事情,例如用戶操作,系統事件或錯誤。
  • 用戶屬性:您定義用來描述用戶群細分的屬性,例如語言首選項或地理位置。

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

在你開始之前

如果尚未將Firebase添加到您的Android項目中,並確保在Firebase項目中啟用了Google Analytics(分析):

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

  • 如果您使用的現有Firebase項目未啟用Google Analytics(分析),請轉到“ >“項目設置”的“集成”標籤以啟用它。

在項目中啟用Google Analytics(分析)後,Firebase應用將鏈接到Google Analytics(分析)數據流。

將Analytics SDK添加到您的應用中

  1. 使用Firebase Android BoM ,在模塊(應用程序級)Gradle文件(通常為app/build.gradle )中聲明Google Analytics(分析)Android庫的依賴app/build.gradle

    爪哇

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

    Kotlin + KTX

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

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

    爪哇

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate()方法中對其進行初始化:

    爪哇

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

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

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

下一步