本快速入門向您展示如何將 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 配置對象。如果您的 Web 應用程序已經使用 Google Analytics,您可能需要執行將Firebase 與現有 gtag.js 標記一起使用中所述的額外設置。
檢查代碼中的 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" };
如果您還沒有安裝 Firebase JS SDK 並初始化 Firebase 。
添加 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()
調用發送到該 ID 的事件將不會與 Firebase 相關聯,並且無法在其他 Firebase 服務中用於定位。
開始記錄事件
初始化分析服務後,您可以開始使用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');
下一步
- 使用DebugView驗證您的事件。
- 在Firebase 控制台中探索您的數據。
- 瀏覽有關事件和用戶屬性的指南。
- 了解如何將數據導出到BigQuery。