記錄事件

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

事件可讓您深入瞭解應用程式情況，例如使用者動作、系統事件或錯誤。

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 控制台的「事件」資訊主頁存取這些資料。這個資訊主頁會顯示系統為應用程式記錄的每種不同事件類型自動建立的事件報表。