開始使用 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');

下一步