ไปที่คอนโซล

Google Analytics(分析)使用入门

本快速入门介绍如何将 Google Analytics(分析)添加到您的应用并开始记录事件。

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

  • 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。
  • 用户属性:您为了描述自己的用户群细分而定义的属性,例如语言偏好或地理位置。

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

准备工作

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

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

将 Analytics SDK 添加到您的应用

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

    implementation 'com.google.firebase:firebase-analytics:17.2.0'
    
  2. 在您的 Activity 的顶部声明 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() 方法记录事件。

某些事件适用于所有应用;其他事件则适用于特定业务类型或行业。您应该同时发送推荐事件及其预设参数,以确保报告能够提供最详细的信息,并让您在未来功能和集成方案推出时马上就能受益。本部分展示了如何记录预定义的事件;如需详细了解如何记录事件,请参阅记录事件

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

后续步骤