本快速入門向您展示如何將 Google Analytics 新增至您的應用程式並開始記錄事件。
Google Analytics 收集您的網路應用程式的使用情況和行為資料。 SDK 記錄兩種主要類型的信息:
事件:您的應用程式中發生的情況,例如使用者操作、系統事件或錯誤。
使用者屬性:您定義的用於描述使用者群細分的屬性,例如語言偏好或地理位置。
分析自動記錄一些事件和使用者屬性;您不需要添加任何程式碼來啟用它們。
在你開始之前
如果您尚未將 Firebase 新增至您的 JavaScript 項目,並確保在您的 Firebase 專案中啟用了 Google Analytics(分析):
如果您要建立新的 Firebase 項目,請在專案建立工作流程期間啟用 Google Analytics。
如果您使用的現有 Firebase 專案未啟用 Google Analytics(分析),請前往您的 Firebase 專案的「整合」標籤
>項目設定以啟用它。
當您在專案中啟用 Google Analytics 時,您的 Firebase Web 應用程式將連結到與App + Web 屬性相關聯的 Google Analytics 資料流。
將 Analytics SDK 添加到您的應用程式
根據您的 Web 應用程式的託管方式,您的配置可能會自動處理,或者您可能需要更新您的Firebase 設定物件。如果您的網路應用程式已使用 Google Analytics,您可能需要執行將Firebase 與現有 gtag.js 標記結合使用中所述的其他設定。
檢查程式碼中的 Firebase 設定物件是否包含
measurementId
。當您在 Firebase 專案中啟用 Analytics 並註冊 Web 應用程式時,會自動建立此 ID,並且需要使用 Analytics。如果您的應用程式使用 Firebase 託管並使用 Firebase SDK 的保留 URL :
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" };
新增 Analytics JS SDK 並初始化 Analytics:
網路模組化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(分析),並且您計劃執行以下操作之一,則您的應用程式可能需要額外設定:
- 將來自 Firebase 的 Google Analytics 呼叫新增至頁面,但也計劃繼續直接在同一頁上使用
gtag()
呼叫。 - 希望在直接
gtag()
呼叫和傳送到 Firebase 的 Google Analytics(分析)資料之間使用相同的測量 ID。
為確保您的活動可供所有 Firebase 服務使用,請完成以下附加設定步驟:
- 刪除行
gtag('config', ' GA_MEASUREMENT_ID ');
其中GA_MEASUREMENT_ID
是 Firebase Web 應用的measurementId
。如果頁面上的其他 Analytics 屬性有其他 ID,則無需刪除其設定行。 - 確保在使用
gtag()
發送任何事件之前呼叫firebase.analytics()
。
否則,透過gtag()
呼叫傳送到該 ID 的事件將不會與 Firebase 關聯,並且無法在其他 Firebase 服務中定位。
開始記錄事件
初始化Analytics 服務後,您可以開始使用logEvent()
方法記錄事件。
建議所有應用程式執行某些事件;其他建議用於特定業務類型或垂直領域。您應該發送建議的事件及其規定的參數,以確保報告中提供最大的可用詳細信息,並從未來可用的功能和整合中受益。本節示範記錄預定義事件,有關記錄事件的更多信息,請參閱記錄事件。
以下範例示範如何記錄推薦事件以指示使用者已在您的應用程式中收到通知:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');