Google 致力于为黑人社区推动种族平等。查看具体举措

Google Analytics(分析)使用入门

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

Google Analytics(分析)会收集您的应用的使用情况和行为数据。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 托管并将预留网址用于 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 Analytics:

Web v8

const analytics = firebase.analytics();

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

将 Firebase 与现有 gtag.js 标记搭配使用

如果您以前使用 gtag.js 代码段在应用中运行 Google Analytics(分析),当您打算执行以下任一操作时,可能需要对您的应用进行额外的设置:

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

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

  • 移除网址中的 [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID)。gtag 代码段应类似于以下内容:

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • 移除 gtag('config', 'GA_MEASUREMENT_ID'); 一行,其中 GA_MEASUREMENT_ID 与 Firebase 配置代码段中的 measurementId 相同。如果您在相应页面上将其他 ID 用于其他 Analytics(分析)媒体资源,则无需移除对应的配置行。

  • 请确保在使用 gtag() 发送任何事件之前先调用 firebase.analytics()

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

开始记录事件

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

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

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

Web v8

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

Web v9

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

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

后续步骤