获取我们在 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来控制库版本。

    Kotlin+KTX

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

    Java

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

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. 在onCreate()方法中初始化它：

    Kotlin+KTX

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

    Java

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

开始记录事件

创建FirebaseAnalytics实例后，您可以开始使用logEvent()方法记录事件。

某些事件被推荐用于所有应用程序；其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数，以确保报告中提供尽可能多的可用详细信息，并在未来可用的功能和集成中受益。本节演示记录预定义事件，有关记录事件的更多信息，请参阅记录事件。

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

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")
}
MainActivity.kt

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);
MainActivity.java

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

下一步

,

本快速入门向您展示如何将 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来控制库版本。

    Kotlin+KTX

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

    Java

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

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. 在onCreate()方法中初始化它：

    Kotlin+KTX

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

    Java

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

开始记录事件

创建FirebaseAnalytics实例后，您可以开始使用logEvent()方法记录事件。

某些事件被推荐用于所有应用程序；其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数，以确保报告中提供尽可能多的可用详细信息，并在未来可用的功能和集成中受益。本节演示记录预定义事件，有关记录事件的更多信息，请参阅记录事件。

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

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")
}
MainActivity.kt

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);
MainActivity.java

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

下一步