Google Analytics(分析)是 Firebase 的分析引擎。如果将 Analytics(分析)与 Crashlytics 结合使用,您可以获得帮助制造问题以及更细致地跟踪崩溃数据的各种功能,例如未遇到崩溃问题的用户数、在崩溃出现之前跟踪特定事件的路径,还可以借助 BigQuery 直观呈现应用的关键指标。
本指南介绍如何将 Google Analytics(分析)添加到设置了 Crashlytics 的应用。如果您尚未将 Crashlytics 添加到您的应用,请先添加。
第 1 步:添加 Firebase 配置文件
将 Firebase Android 配置文件添加到您的应用:
打开您的项目设置。在您的应用卡片中,选择需要配置文件的应用的软件包名称。
点击下载 google-services.json,获取 Firebase Android 配置文件 (
google-services.json
)。- 您可以随时再次下载 Firebase Android 配置文件。
- 请确保该配置文件名未附加其他字符,如
(2)
。
将配置文件移到应用的模块(应用级)目录中。
如需在 Android 应用中启用 Firebase 产品,请将 google-services 插件添加到 Gradle 文件中。
在根级(项目级)Gradle 文件 (
build.gradle
) 中添加规则,以纳入 Google 服务 Gradle 插件。此外,请确认您拥有 Google 的 Maven 代码库。buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.13' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
在您的模块(应用级)Gradle 文件(通常是
app/build.gradle
)中,应用 Google 服务 Gradle 插件。apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
第 2 步:将 Analytics SDK 添加到您的应用
使用 Firebase Android BoM 在模块(应用级)Gradle 文件(通常为
app/build.gradle
)中声明 Analytics Android 库的依赖项。Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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 { // Declare 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.1.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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 { // Declare 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.1.0' }
在您的 Activity 的顶部声明
com.google.firebase.analytics.FirebaseAnalytics
对象:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
在
onCreate()
方法中初始化该对象:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
后续步骤
- 使用 DebugView 验证事件。
- 在 Firebase 控制台中浏览数据。
- 浏览事件和用户属性的相关指南。
- 了解如何将数据导出到 BigQuery。