本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您的网络应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 JavaScript 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 网络应用程序将链接到与App + Web 属性关联的 Google Analytics 数据流。
将 Analytics SDK 添加到您的应用程序
根据您的 Web 应用程序的托管方式,您的配置可能会自动处理,或者您可能需要更新您的Firebase 配置对象。如果您的 Web 应用程序已经使用 Google Analytics,您可能需要执行将 Firebase 与现有 gtag.js 标记一起使用中所述的额外设置。
检查代码中的 Firebase 配置对象是否包含
measurementId
。当您在 Firebase 项目中启用 Analytics 并注册网络应用程序时,会自动创建此 ID,并且它是使用 Analytics 所必需的。如果您的应用使用 Firebase 托管并使用 Firebase SDK 的保留网址:
Firebase 会自动处理您的应用程序的配置。要完成设置,请将项目设置中“你的应用程序”卡中的脚本添加到应用程序的 <body> 标记(如果尚未添加)。
如果您的应用不使用保留网址:如果您使用的是现有网络应用,请更新代码中的 Firebase 配置对象以确保存在
measurementId
字段。配置对象应类似于以下示例:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
如果您还没有安装 Firebase JS SDK 并初始化 Firebase 。
添加 Analytics JS SDK 并初始化 Analytics:
Web version 9
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web version 8
import firebase from "firebase/app"; import "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
将 Firebase 与现有的 gtag.js 代码结合使用
如果您之前使用gtag.js 代码段在您的应用中运行 Google Analytics,如果您计划执行以下操作之一,您的应用可能需要额外设置:
- 将来自 Firebase 的 Google Analytics 调用添加到页面,但还计划继续直接在同一页面上使用
gtag()
调用。 - 想要在直接
gtag()
调用和发送到 Firebase 的 Google Analytics 数据之间使用相同的测量 ID。
为确保您的事件可供所有 Firebase 服务使用,请完成以下额外的设置步骤:
- 删除行
gtag('config', ' GA_MEASUREMENT_ID ');
其中GA_MEASUREMENT_ID
是您的 Firebase 网络应用的measurementId
。如果页面上有其他 Analytics 属性的其他 ID,则不需要删除它们的配置行。 - 确保在使用 gtag() 发送任何事件之前调用
firebase.analytics()
gtag()
。
否则,使用gtag()
调用发送到该 ID 的事件将不会与 Firebase 相关联,并且无法在其他 Firebase 服务中用于定位。
开始记录事件
初始化分析服务后,您可以开始使用logEvent()
方法记录事件。
某些事件被推荐用于所有应用程序;其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数,以确保报告中提供尽可能多的可用详细信息,并在未来可用的功能和集成中受益。本节演示记录预定义事件,有关记录事件的更多信息,请参阅记录事件。
以下示例演示了如何记录推荐事件以指示用户已在您的应用程序中收到通知:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web version 8
firebase.analytics().logEvent('notification_received');
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。
本快速入门向您展示如何将 Google Analytics 添加到您的应用程序并开始记录事件。
Google Analytics 收集您的网络应用程序的使用情况和行为数据。 SDK 记录两种主要类型的信息:
事件:您的应用程序中发生的事情,例如用户操作、系统事件或错误。
用户属性:您定义的用于描述用户群细分的属性,例如语言偏好或地理位置。
Analytics 自动记录一些事件和用户属性;您无需添加任何代码即可启用它们。
在你开始之前
如果您还没有,请将 Firebase 添加到您的 JavaScript 项目并确保在您的 Firebase 项目中启用了 Google Analytics:
如果您要创建新的 Firebase 项目,请在项目创建工作流程中启用 Google Analytics。
如果您使用的是未启用 Google Analytics 的现有 Firebase 项目,请转到设置的“集成”选项卡 >项目设置 启用它。
当您在项目中启用 Google Analytics 时,您的 Firebase 网络应用程序将链接到与App + Web 属性关联的 Google Analytics 数据流。
将 Analytics SDK 添加到您的应用程序
根据您的 Web 应用程序的托管方式,您的配置可能会自动处理,或者您可能需要更新您的Firebase 配置对象。如果您的 Web 应用程序已经使用 Google Analytics,您可能需要执行将 Firebase 与现有 gtag.js 标记一起使用中所述的额外设置。
检查代码中的 Firebase 配置对象是否包含
measurementId
。当您在 Firebase 项目中启用 Analytics 并注册网络应用程序时,会自动创建此 ID,并且它是使用 Analytics 所必需的。如果您的应用使用 Firebase 托管并使用 Firebase SDK 的保留网址:
Firebase 会自动处理您的应用程序的配置。要完成设置,请将项目设置中“你的应用程序”卡中的脚本添加到应用程序的 <body> 标记(如果尚未添加)。
如果您的应用不使用保留网址:如果您使用的是现有网络应用,请更新代码中的 Firebase 配置对象以确保存在
measurementId
字段。配置对象应类似于以下示例:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
如果您还没有安装 Firebase JS SDK 并初始化 Firebase 。
添加 Analytics JS SDK 并初始化 Analytics:
Web version 9
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web version 8
import firebase from "firebase/app"; import "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
将 Firebase 与现有的 gtag.js 代码结合使用
如果您之前使用gtag.js 代码段在您的应用中运行 Google Analytics,如果您计划执行以下操作之一,您的应用可能需要额外设置:
- 将来自 Firebase 的 Google Analytics 调用添加到页面,但还计划继续直接在同一页面上使用
gtag()
调用。 - 想要在直接
gtag()
调用和发送到 Firebase 的 Google Analytics 数据之间使用相同的测量 ID。
为确保您的事件可供所有 Firebase 服务使用,请完成以下额外的设置步骤:
- 删除行
gtag('config', ' GA_MEASUREMENT_ID ');
其中GA_MEASUREMENT_ID
是您的 Firebase 网络应用的measurementId
。如果页面上有其他 Analytics 属性的其他 ID,则不需要删除它们的配置行。 - 确保在使用 gtag() 发送任何事件之前调用
firebase.analytics()
gtag()
。
否则,使用gtag()
调用发送到该 ID 的事件将不会与 Firebase 相关联,并且无法在其他 Firebase 服务中用于定位。
开始记录事件
初始化分析服务后,您可以开始使用logEvent()
方法记录事件。
某些事件被推荐用于所有应用程序;其他建议用于特定的业务类型或垂直行业。您应该发送建议的事件及其规定的参数,以确保报告中提供尽可能多的可用详细信息,并在未来可用的功能和集成中受益。本节演示记录预定义事件,有关记录事件的更多信息,请参阅记录事件。
以下示例演示了如何记录推荐事件以指示用户已在您的应用程序中收到通知:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web version 8
firebase.analytics().logEvent('notification_received');
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。