获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用 Google 分析

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本快速入门向您展示了如何将 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 配置对象。如果您的网络应用已使用 Google Analytics,您可能需要执行将 Firebase 与现有 gtag.js 标记一起使用中所述的其他设置。

  1. 检查代码中的 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"
      };
      
  2. 如果您还没有,请安装 Firebase JS SDK 并初始化 Firebase

  3. 添加 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 服务中定位。

开始记录事件

初始化Analytics 服务后,您可以开始使用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');

下一步