開始使用 Google Analytics

本快速入門導覽課程將說明如何將 Google Analytics 新增到您的應用程式 開始記錄事件。

Google Analytics 會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要類型的資訊：

  • 事件：應用程式運作情況，例如使用者動作、系統 事件或錯誤
  • 使用者屬性：您定義的屬性，用來描述區隔 例如語言偏好設定或地理位置

Analytics 會自動記錄 事件和 使用者屬性； 不需要新增任何程式碼

事前準備

如果您尚未將 Firebase 新增至 JavaScript，請先完成這項操作。 專案，並確認已啟用 Google Analytics 建立專案：

  • 如要建立新的 Firebase 專案，請啟用 Google Analytics 專案建立流程

  • 如果您使用的現有 Firebase 專案沒有 啟用 Google Analytics 後，請前往 整合 > 的分頁 (專案設定) 即可啟用。

為專案啟用 Google Analytics 後，Firebase 網頁應用程式 已連結至 Google Analytics 資料串流 應用程式 + 網站資源：

在應用程式中加入 Analytics SDK

視網頁應用程式的託管方式而定，您的設定可能會 否則可能需要更新 Firebase 設定物件。 如果您的網站應用程式已經使用 Google Analytics，則可能需要執行額外的動作 請參閱「搭配現有的 gtag.js 標記使用 Firebase」一文。

  1. 確認程式碼中的 Firebase 設定物件含有 measurementId。如果您啟用 在 Firebase 專案中使用 Analytics 並註冊網頁應用程式 才能使用 Analytics

    • 如果您的應用程式使用 Firebase 託管「且」使用 Firebase SDK 的保留網址：

      Firebase 會自動處理應用程式設定。如要完成這項程序 請前往以下位置設定「您的應用程式」資訊卡中的指令碼： 專案設定 給<body>加上其中一個標記

    • 如果您的應用程式沒有使用保留網址： 如果您使用現有的網頁應用程式，請更新 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 JS SDK 並初始化 Firebase。

  3. 加入 Analytics JS SDK 並初始化 Analytics：

Web 

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 

import firebase from "firebase/compat/app";
import "firebase/compat/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 程式碼片段， 如果您打算採取下列任一做法，則可能需要完成額外設定：

  • 將 Firebase 的 Google Analytics 呼叫加進網頁，但也規劃 繼續在相同網頁上使用 gtag() 呼叫。
  • 希望在直接gtag()直接通話和 傳送到 Firebase 的 Google Analytics 資料。

為確保所有 Firebase 服務都能使用事件，請填妥 下列額外的設定步驟：

  • 移除這一行 gtag('config', 'GA_MEASUREMENT_ID'); 其中 GA_MEASUREMENT_ID 是您的 measurementId Firebase 網頁應用程式。如果其他 Analytics 資源有其他 ID 您不需要移除該部分的設定行。
  • 傳送任何活動前，請務必先呼叫 firebase.analytics() gtag()。

否則，透過 gtag() 呼叫傳送至該 ID 的事件不會建立關聯 無法用於其他指定目標 Firebase 服務。

開始記錄事件

初始化 Analytics 服務，您可以 開始記錄事件 logEvent()敬上 方法。

有些事件是 建議用於所有應用程式； 有些則適合特定業務類型或產業使用。您應該傳送 建議事件及其相關的指定參數，以確保 方便您使用日後推出的功能 整合。本節說明如何將 預先定義的事件，如要進一步瞭解記錄事件，請參閱 記錄事件。

下列範例說明如何記錄建議的事件，以指出 使用者收到了您應用程式的通知：

Web

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

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

Web

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

後續步驟