Catch up on everthing we announced at this year's Firebase Summit. Learn more

開始使用 Google Analytics

本快速入門向您展示如何將 Google Analytics 添加到您的應用程序並開始記錄事件。

Google Analytics 會收集您的網絡應用程序的使用和行為數據。 SDK 記錄兩種主要類型的信息:

  • 事件:什麼是發生在你的應用程序,如用戶操作,系統事件或錯誤。

  • 用戶屬性:屬性定義來描述你的用戶群的細分,如語言偏好或地理位置。

Analytics(分析)會自動記錄一些事件用戶屬性;您無需添加任何代碼即可啟用它們。

在你開始之前

如果你還沒有準備好,加入到火力地堡你的JavaScript項目,並確保谷歌Analytics(分析)在您的火力地堡項目啟用:

  • 如果您要創建新的 Firebase 項目,請在項目創建工作流程中啟用 Google Analytics。

  • 如果您使用的是沒有啟用谷歌分析,去到一個現有的火力地堡項目集成的標籤頁 >項目設置來啟用它。

當啟用了谷歌分析你的項目,你的火力地堡網絡應用程序鏈接到谷歌Analytics(分析)數據流與相關的應用程序+網站資源

將 Analytics SDK 添加到您的應用程序

根據您的Web應用程序是如何託管,您的配置可以自動處理,或者您可能需要更新您的火力地堡的配置對象。如果你的Web應用程序已經在使用谷歌分析,你可能需要做中介紹的其他設置使用火力地堡與現有gtag.js標記

  1. 檢查你的代碼的火力地堡的配置對象包含measurementId 。當您在 Firebase 項目中啟用 Analytics 並註冊網絡應用程序時,會自動創建此 ID,並且它是使用 Analytics 所必需的。

    • 如果應用程序使用火力地堡託管用途保留網址為火力地堡的SDK:

      Firebase 會自動處理您的應用程序的配置。要完成設置,在您添加從您的應用卡的腳本項目設置到您的應用程序的<body>標籤,如果你還沒有。

    • 如果您的應用程序不使用保留的網址如果你使用現有的網絡應用程序,在你的代碼更新火力地堡配置對象,以確保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 分析:

網頁版 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

網頁版 8

const analytics = firebase.analytics();

將 Firebase 與現有的 gtag.js 標記結合使用

如果你以前有谷歌分析在您的應用程序運行使用gtag.js片斷,你的應用程序可能需要額外的設置,如果你打算做下列之一:

  • 從火力地堡添加谷歌Analytics(分析)調用的頁面,而且打算繼續使用gtag()直接在同一頁面上調用。
  • 想用直接的相同的測量ID gtag()發送到火力地堡電話和谷歌Analytics(分析)數據。

為確保您的事件可供所有 Firebase 服務使用,請完成以下額外設置步驟:

  • 刪除行gtag('config', ' GA_MEASUREMENT_ID ');其中GA_MEASUREMENT_IDmeasurementId你的火力地堡的Web應用程序的。如果頁面上的其他 Analytics 屬性有其他 ID,則無需刪除它們的配置行。
  • 請務必與firebase.analytics()先寄與任何事件gtag()

否則,事件發送到與該ID gtag()調用不會與火力地堡相關聯,並在其他火力地堡服務目標將無法使用。

開始記錄事件

你已經初始化後分析服務,你就可以開始記錄事件與logEvent()方法。

某些事件被推薦用於所有應用;其他建議用於特定業務類型或垂直行業。您應該發送建議的事件及其規定的參數,以確保報告中的最大可用細節,並在未來的功能和集成可用時受益。本節演示登錄預先定義的事件,對日誌記錄事件的更多信息,請參閱日誌事件

以下示例演示瞭如何記錄推薦事件以指示用戶已在您的應用中收到通知:

網頁版 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

網頁版 8

firebase.analytics().logEvent('notification_received');

下一步