Google 致力于为黑人社区推动种族平等。查看具体举措。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

開始使用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();
index.js

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();
analytics_initialize.js

將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');
index.js

Web v9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

下一步