Vai alla console

Android 版 Google Analytics(分析)使用入门

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

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

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

Analytics(分析)会自动记录某些事件用户属性,您无需为启用这些功能添加任何代码。

准备工作

如果您要创建新项目,请将 Firebase 添加到您的 Android 项目,并按照步骤操作,在项目创建期间为您的项目设置 Google Analytics(分析)。

如果您已有项目,但未配置 Google Analytics(分析),则可以从“settings”>“项目设置”集成标签页中将 Google Analytics(分析)与您的项目关联。

将 Analytics(分析)添加到您的应用

  1. 将 Android 版 Google Analytics(分析)库的依赖项添加到您的模块(应用级)Gradle 文件(通常为 app/build.gradle):

    implementation 'com.google.firebase:firebase-analytics:17.2.0'
    
  2. 在活动顶端声明 com.google.firebase.analytics.FirebaseAnalytics 对象:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate() 方法中对它进行初始化:

    Java

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

    Kotlin

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

记录事件

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

当用户点击您应用中的某个特定元素时,以下代码会记录一个 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 中显示您的事件,帮助您立即验证所发送的事件。

后续步骤