Google Analytics(分析)會收集您的網絡應用的使用情況和行為數據。 SDK記錄兩種主要類型的信息:
事件:您的應用程序中發生的事情,例如用戶操作,系統事件或錯誤。
用戶屬性:您定義的屬性,用於描述用戶群的細分,例如語言首選項或地理位置。
Analytics(分析)自動記錄一些事件和用戶屬性;您無需添加任何代碼即可啟用它們。
在你開始之前
如果尚未將Firebase添加到JavaScript項目中,並確保在Firebase項目中啟用了Google Analytics(分析):
如果您要創建新的Firebase項目,請在項目創建工作流程中啟用Google Analytics(分析)。
如果您使用的現有Firebase項目未啟用Google Analytics(分析),請轉到“ 集成”標籤以啟用它。
>“項目設置”的“
在項目中啟用Google Analytics(分析)後,Firebase Web應用程序將鏈接到與App + Web屬性關聯的Google Analytics(分析)數據流。
將Analytics SDK添加到您的應用中
根據您的Web應用程序的託管方式,您的配置可能會自動處理,或者您可能需要更新Firebase配置對象。如果您的網絡應用已使用Google Analytics(分析),則您可能需要執行將現有的gtag.js標記與Firebase結合使用中所述的其他設置。
檢查代碼中的Firebase配置對像是否包含
measurementId
。當您在Firebase項目中啟用Google Analytics(分析)並註冊一個Web應用程序時,會自動創建此ID,並且需要使用Analytics(分析)。如果您的應用使用Firebase託管並為Firebase SDK使用保留的URL :
Firebase會自動處理配置您的應用程序。要完成設置,請將腳本從“項目”設置中的“應用程序”卡添加到應用程序的<body>標記(如果尚未添加)。
如果您的應用程序不使用保留的URL :如果您使用的是現有的Web應用程序,請更新代碼中的Firebase配置對象,以確保
measurementId
字段存在。 config對象應類似於以下示例:// 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 Analytics:
Web v8
const analytics = firebase.analytics();
Web v9
import { getAnalytics } from "firebase/analytics"; const analytics = getAnalytics();
將Firebase與現有gtag.js標記一起使用
如果您以前使用gtag.js片段在自己的應用中運行了Google Analytics(分析),則如果您打算執行以下操作之一,則您的應用可能需要進行其他設置:
- 將來自Firebase的Google Analytics(分析)調用添加到該頁面,但還計劃繼續直接在同一頁面上繼續使用
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
相同。如果頁面上具有其他Google Analytics(分析)屬性的其他ID,則無需刪除其配置行。請務必與
firebase.analytics()
先寄與任何事件gtag()
否則,通過gtag()
調用發送到該ID的事件將不會與Firebase關聯,也無法在其他Firebase服務中定位。
開始記錄事件
你已經初始化後分析服務與'firebase.analytics()' ,你就可以開始記錄與事件'的LogEvent()“方法。
建議對所有應用程序都使用某些事件;對於特定的業務類型或行業,建議使用其他類型。您應該發送建議的事件及其規定的參數,以確保最大程度地利用報告中的詳細信息,並在將來可用的功能和集成中受益。本節演示如何記錄預定義的事件,有關記錄事件的更多信息,請參見記錄事件。
下面的示例演示如何記錄推薦事件,以指示用戶已在您的應用程序中收到通知:
Web v8
firebase.analytics().logEvent('notification_received');
Web v9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');