获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用 Google 分析

本快速入门向您展示了如何将 Google Analytics 添加到您的应用程序并开始记录事件。

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

  • 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
  • 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。

Analytics 会自动记录一些事件用户属性;您无需添加任何代码即可启用它们。

在你开始之前

如果您还没有,请将 Firebase 添加到您的 Android 项目中,并确保在您的 Firebase 项目中启用了 Google Analytics:

  • 如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。

  • 如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到 >项目设置集成选项卡以启用它。

当您在项目中启用 Google Analytics 时,您的 Firebase 应用会链接到 Google Analytics 数据流。

将 Analytics SDK 添加到您的应用程序

  1. 在您的模块(应用级)Gradle 文件(通常是<project>/<app-module>/build.gradle )中,添加 Analytics Android 库的依赖项。我们建议使用Firebase Android BoM来控制库版本控制。

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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.2.0'
    }
    

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

开始记录事件

创建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+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")
}

您可以启用详细日志记录以监控 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 中显示您的事件,帮助您立即验证是否正在发送事件。

下一步