Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

开始使用 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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. onCreate()方法中初始化它:

    Kotlin+KTX

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

    Java

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

开始记录事件

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

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);

您可以启用详细日志记录来监视 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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. onCreate()方法中初始化它:

    Kotlin+KTX

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

    Java

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

开始记录事件

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

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);

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

下一步