Google Analytics(分析)使用入门

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

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

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

  • 用户属性:您为了描述自己的用户群细分而定义的属性,例如语言偏好或地理位置。

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

准备工作

您可以根据使用的是新 Web 应用还是现有 Web 应用,通过下面的相应方式将 Analytics(分析)与您的 Firebase 项目关联:

  • 如果您要创建新项目,请将 Firebase 添加到您的 JavaScript 项目,并按照相应步骤操作,为您的 Firebase 项目设置 Google Analytics(分析)。出现提示时,选择关联现有的 Google Analytics(分析)帐号,或创建一个新帐号。
  • 如果您已有项目,但未配置 Google Analytics(分析),则可以通过“设置”>“项目设置”下的集成标签页将 Google Analytics(分析)与您的项目关联。
  • 如果您已有项目,并已在 2019 年 7 月 31 日之前配置 Analytics(分析),则需要通过项目设置的集成标签页免费升级该项目,以享受完整的 Google Analytics(分析)体验。

完成以下任一步骤,便可成功将您的 Firebase 项目关联到与“应用 + 网站”媒体资源相关的 Google Analytics(分析)数据流。

将 Analytics SDK 添加到您的应用

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

  • 如果您的应用使用 Firebase 托管预留网址用于 Firebase SDK

    1. Firebase 会自动处理您的应用的配置。要完成设置,请将项目设置您的应用卡片内的相应脚本添加到应用的 <body> 标记(如果您尚未添加)。
  • 如果您的应用未使用预留网址

    1. 项目设置您的应用卡片内的相应配置对象添加到应用的 <body> 标记。
    2. 如果您使用的是现有 Web 应用,请更新 Firebase 配置对象以确保 measurementId 字段存在。需要将 Google Analytics(分析)与您的 Web 应用结合使用。配置对象应类似于以下示例:

      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 与现有 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()”方法记录事件。

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

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

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

后续步骤