Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now

開始使用Google Analytics(分析)

本快速入門介紹瞭如何將Google Analytics(分析)添加到您的應用並開始記錄事件。

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結合使用中所述的其他設置。

  1. 檢查代碼中的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"
      };
      
  2. 初始化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');

下一步