記錄事件

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

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

Analytics 會自動記錄部分活動記錄 事件；你不是 必須新增任何程式碼才能接收代碼。如果您的應用程式需要收集 資料中，您最多可以在應用程式中記錄 500 種不同的 Analytics 事件類型。 應用程式記錄的事件總數沒有上限。請注意， 名稱有大小寫之分，且記錄的兩個事件名稱只有 會導致兩個不同的事件。

事前準備

確認您已經設定專案，並且可以按照 開始使用 Analytics。

記錄事件

完成設定 firebase.analytics() 執行個體， 您就可以開始使用 logEvent() 方法。如果您已熟悉 Google Analytics 的使用方式，這個方法 相當於在 event 中使用 gtag.js。

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這個資訊主頁會顯示事件報表 系統會根據記錄到的每種事件類型，