本快速入門向您展示如何將 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:32.1.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.3.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.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.3.0' }
在活動頂部聲明
com.google.firebase.analytics.FirebaseAnalytics
對象:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
在
onCreate()
方法中初始化它:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
開始記錄事件
創建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") }
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);
您可以啟用詳細日誌記錄來監視 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。