开始使用 Google Analytics(分析)

本快速入门介绍如何将 Google Analytics(分析)添加到您的应用并开始记录事件。

Google Analytics(分析)会收集您的 Web 应用的使用情况和行为数据。SDK 会记录以下两种主要类型的信息:

  • 事件:您的应用中发生了什么,例如用户操作、系统事件或错误。

  • 用户属性:您为描述自己的各个细分用户群而定义的特性,例如语言首选项或地理位置。

Analytics 会自动记录某些事件用户属性;您无需为此添加任何代码。

准备工作

将 Firebase 添加到您的 JavaScript 项目(如果尚未添加),并确保在 Firebase 项目中启用了 Google Analytics(分析):

  • 如果您要创建新的 Firebase 项目,请在项目创建过程中启用 Google Analytics(分析)。

  • 如果您使用的是现有 Firebase 项目,而该项目未启用 Google Analytics(分析),请前往 >“项目设置”,然后在集成标签页中启用该服务。

在项目中启用 Google Analytics(分析)后,您的 Firebase Web 应用将关联到与“应用 + 网站”媒体资源相关的 Google Analytics(分析)数据流。

将 Analytics SDK 添加到您的应用

您的配置可能会自动进行处理,或者您可能需要更新 Firebase 配置对象,具体取决于您的 Web 应用的托管方式。如果您的 Web 应用已在使用 Google Analytics(分析),您可能需要按将 Firebase 与现有 gtag.js 标记搭配使用中所述进行额外的设置。

  1. 确认代码中的 Firebase 配置对象包含 measurementId。当您在 Firebase 项目中启用 Analytics 并注册 Web 应用时,系统会自动创建此 ID,在使用 Analytics 时需要用到此 ID。

    • 如果您的应用使用 Firebase Hosting 并将预留网址用于 Firebase SDK

      Firebase 会自动处理您的应用的配置。为完成设置,请将项目设置您的应用卡片内的相应脚本添加到应用的 <body> 标记中(如果您尚未添加)。

    • 如果您的应用未使用预留网址如果您使用的是现有 Web 应用,请更新代码中的 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 模块化 API

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 命名空间型 API

import firebase from "firebase/compat/app";
import "firebase/compat/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(分析),当您打算执行以下任一操作时,可能需要对您的应用进行额外的设置:

  • 将 Google Analytics(分析)调用从 Firebase 添加到相应页面,但还打算直接在同一页面上继续使用 gtag() 调用。
  • 想要在直接的 gtag() 调用与发送到 Firebase 的 Google Analytics(分析)数据之间使用相同的衡量 ID。

为确保事件可供所有 Firebase 服务使用,请完成以下额外的设置步骤:

  • 移除 gtag('config', 'GA_MEASUREMENT_ID'); 一行,其中 GA_MEASUREMENT_ID 是 Firebase Web 应用的 measurementId。如果您在相应页面上还有其他 ID 用于其他 Analytics(分析)媒体资源,则无需移除对应的配置行。
  • 请确保在使用 gtag() 发送任何事件之前先调用 firebase.analytics()

否则,通过 gtag() 调用发送到此 ID 的事件将不会与 Firebase 关联,并且无法用于在其他 Firebase 服务中定位。

开始记录事件

初始化 Analytics 服务后,您可以开始使用 logEvent() 方法记录事件。

某些事件推荐用于所有应用;其他事件则推荐用于特定业务类型或行业。您应该同时发送推荐事件及预设参数,以确保报告能够提供最详细的信息,并让您在未来功能和集成方案推出时马上就能受益。本部分展示了如何记录预定义的事件;如需详细了解如何记录事件,请参阅记录事件

下面的示例展示了如何记录推荐事件,以表明用户已在应用中收到通知:

Web 模块化 API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web 命名空间型 API

firebase.analytics().logEvent('notification_received');

后续步骤