記錄事件


本指南說明如何在應用程式中記錄事件。

事件可讓你深入瞭解應用程式中的活動，例如使用者動作、系統事件或錯誤。

Analytics會自動記錄部分事件，您無需新增任何程式碼即可接收這些事件。如果應用程式需要收集其他資料，您可以在應用程式中記錄最多 500 種不同的Analytics事件類型。應用程式記錄的事件總量沒有上限。請注意，事件名稱區分大小寫。也就是說，如果兩個事件只有名稱大小寫不同，記錄上仍會顯示為兩個不同的事件。

事前準備

請確認您已設定專案，並可存取 Analytics，詳情請參閱「開始使用 Analytics」。

記錄事件

設定 firebase.analytics() 執行個體後，即可開始使用 logEvent() 方法記錄事件。如果您已熟悉 Google Analytics，這個方法等同於在 gtag.js 中使用 event 指令。

為協助您著手使用，Analytics SDK 定義了許多建議事件，這些事件在不同類型的應用程式中都很常見，包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件和使用時機，請參閱「建議事件」。

注意：如要取得最詳盡的報表資料，請記錄適合您應用程式的建議事件及其對應參數。此外，您還能享有日後推出的最新 Google Analytics 功能。

如要瞭解多個事件及其參數的導入詳細資料，請參閱 gtag.js 事件參考資料。

以下範例說明如何記錄 select_content 事件：

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});
analytics_log_event_params.js

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});
index.js

除了規定的參數外，您還可以在任何事件中加入下列參數：

  • 自訂參數：自訂參數可用於Analytics報表中的維度或指標。您可以將自訂維度用於非數值的事件參數資料，並將自訂指標用於以數值表示的參數資料。使用 SDK 記錄自訂參數後，請註冊維度或指標，確保這些自訂參數會顯示在 Analytics 報表中。方法是依序前往「Analytics」>「事件」>「管理自訂定義」>「建立自訂維度」。

    自訂參數可用於目標對象定義，且可套用至每份報表。如果應用程式已連結至 BigQuery 專案，匯出至 BigQuery 的資料也會包含自訂參數。如要查看範例查詢及更多資訊，請前往 Google Analytics 4 BigQuery Export。

  • value 參數：value 是一般用途的參數，可用於累計與事件相關的重要指標。例如收益、距離、時間和點數。

如果應用程式有特定需求，而建議事件類型無法滿足，您可以記錄自己的自訂事件。舉例來說，如果您正在開發遊戲，並想追蹤玩家何時完成特定目標，可以記錄類似下列範例的事件：

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
analytics_log_event_custom_params.js

Web

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
index.js

在資訊主頁中查看活動

您可以在Firebase控制台資訊主頁中，查看事件的匯總統計資料。這些資訊主頁會在一天內定期更新。如要立即測試，請使用上一節所述的 logcat 輸出內容。

您可以在 Firebase 控制台的「Events」(事件) 資訊主頁中存取這項資料。這個資訊主頁會顯示系統自動為應用程式記錄的每種不同事件類型建立的事件報表。