Google Analytics(分析)会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息:
- 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
- 用户属性:您为了描述自己的用户群细分而定义的属性,例如语言偏好或地理位置。
Analytics(分析)会自动记录某些事件和用户属性;您无需为此添加任何代码。
准备工作
如果您要创建新项目,请将 Firebase 添加到您的 Android 项目,并按照相应步骤操作,在项目创建期间为您的项目设置 Google Analytics(分析)。
如果您已有项目,但未配置 Google Analytics(分析),则可以从 集成标签页中将 Google Analytics(分析)与您的项目关联。
> 项目设置的将 Analytics SDK 添加到您的应用
将 Android 版 Google Analytics(分析)库的依赖项添加到您的模块(应用级)Gradle 文件(通常为
app/build.gradle
):implementation 'com.google.firebase:firebase-analytics:17.2.1'
在您的 Activity 的顶部声明
com.google.firebase.analytics.FirebaseAnalytics
对象:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin
private lateinit var firebaseAnalytics: FirebaseAnalytics
在
onCreate()
方法中初始化该对象:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = FirebaseAnalytics.getInstance(this)
开始记录事件
创建 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
val bundle = Bundle() bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id) bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name) bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image") firebaseAnalytics.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。