本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
- 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
- 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 Android 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 应用程序会链接到 Google Analytics 数据流。
将 Analytics SDK 添加到您的应用程序
在您的模块(应用程序级)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' }
在活动顶部声明
com.google.firebase.analytics.FirebaseAnalytics
对象:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
在
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 中显示您的事件,帮助您立即验证是否正在发送事件。
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。
本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
- 事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
- 用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 Android 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 应用程序会链接到 Google Analytics 数据流。
将 Analytics SDK 添加到您的应用程序
在您的模块(应用程序级)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' }
在活动顶部声明
com.google.firebase.analytics.FirebaseAnalytics
对象:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
在
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 中显示您的事件,帮助您立即验证是否正在发送事件。
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。