开始在 Android 上使用 Google Analytics for Firebase

Google Analytics for Firebase 会为您的应用收集使用情况数据和行为数据。SDK 会记录两种主要类型的信息:

  • 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。

  • 用户属性:为描述您的各个细分用户群而定义的属性,例如语言首选项或地理位置。

Analytics 会自动记录某些事件用户属性;您无需为此添加任何代码。

前提条件

将 Analytics 添加到您的应用

将 Google Analytics for Firebase 的依赖项添加到您的应用级 build.gradle 文件:

implementation 'com.google.firebase:firebase-core:16.0.6'

在活动顶端声明 com.google.firebase.analytics.FirebaseAnalytics 对象:

Java
Android

private FirebaseAnalytics mFirebaseAnalytics;

Kotlin
Android

private lateinit var firebaseAnalytics: FirebaseAnalytics

然后在 onCreate() 方法中将其初始化:

Java
Android

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

Kotlin
Android

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = FirebaseAnalytics.getInstance(this)

记录事件

在创建 FirebaseAnalytics 实例后,您可以通过 logEvent() 方法用该实例记录预定义事件或自定义事件。您可以在 FirebaseAnalytics.EventFirebaseAnalytics.Param 参考文档中查看预定义的事件和参数。

当用户点击您应用中的某个特定元素时,以下代码会记录一个 SELECT_CONTENT 事件。

Java
Android

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
Android

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 中显示您的事件,帮助您立即验证所发送的事件。

后续步骤

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面