本快速入門導覽課程說明如何將 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」一文。
確認程式碼中的 Firebase 設定物件含有
measurementId
。如果您啟用 在 Firebase 專案中Analytics並註冊網頁應用程式, 才能使用 Analytics。如果您的應用程式使用 Firebase Hosting「和」 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" };
如果您還沒有這樣做, 安裝 Firebase JS SDK 並初始化 Firebase。
新增 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()
直接通話和 已將 Google Analytics 資料傳送至 Firebase。
為確保所有 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');
Web
firebase.analytics().logEvent('notification_received');
後續步驟
- 解讀每份 Analytics 報表。
- 使用 DebugView 驗證事件。
- 在 Firebase 控制台中探索資料。
- 瀏覽活動指南,和 使用者屬性。
- 瞭解如何將資料匯出至 BigQuery。