記錄事件

本指南向您展示如何在您的應用程序中記錄事件。

事件可讓您深入了解應用程序中發生的情況,例如用戶操作、系統事件或錯誤。

Analytics 會自動為您記錄一些事件;您無需添加任何代碼即可接收它們。如果您的應用需要收集額外數據,您可以在應用中記錄多達 500 種不同的分析事件類型。您的應用程序記錄的事件總量沒有限制。請注意,事件名稱區分大小寫,並且記錄兩個名稱僅大小寫不同的事件將導致兩個不同的事件。

在你開始之前

確保您已設置項目並可以訪問 Analytics,如開始使用 Analytics中所述。

記錄事件

配置firebase.analytics()實例後,您可以開始使用logEvent()方法記錄事件。如果您已經熟悉 Google Analytics,此方法等效於使用gtag.js中的event命令。

為了幫助您入門,Analytics SDK 定義了許多推薦事件,這些事件在不同類型的應用程序中很常見,包括零售和電子商務、旅遊和遊戲應用程序。要了解有關這些事件以及何時使用它們的更多信息,請參閱推薦事件

注意:要在報告中獲得最大的詳細信息,請記錄對您的應用程序及其規定參數有意義的推薦事件。這也可確保您在最新推出的 Google Analytics(分析)功能中受益。

您可以在gtag.js 事件參考中找到多個事件及其參數的實現細節。

以下示例演示瞭如何記錄select_content事件:

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web version 8

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

除了規定的參數外,您還可以將以下參數添加到任何事件中:

  • 自定義參數:自定義參數可用作Analytics 報告中的維度或指標。您可以將自定義維度用於非數字事件參數數據,並將自定義指標用於任何以數字方式更好地表示的參數數據。使用 SDK 記錄自定義參數後,註冊維度或指標以確保這些自定義參數出現在 Analytics 報告中。通過以下方式執行此操作:分析 > 事件 > 管理自定義定義 > 創建自定義維度

    自定義參數可用於可應用於每個報告的受眾定義。如果您的應用與 BigQuery 項目相關聯,則自定義參數也會包含在導出到 BigQuery的數據中。在Google Analytics 4 BigQuery Export中查找示例查詢等。

  • value參數: value是一個通用參數,可用於累積與事件相關的關鍵指標。示例包括收入、距離、時間和積分。

如果您的應用程序具有推薦的事件類型未涵蓋的特定需求,您可以記錄自己的自定義事件。例如,如果您正在開發遊戲並希望跟踪玩家何時完成特定目標,您可以記錄類似於以下示例的事件:

Web version 9

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

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

Web version 8

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

在儀表板中查看事件

您可以在 Firebase 控制台信息中心查看有關您的事件的匯總統計信息。這些儀表板全天定期更新。要立即進行測試,請使用上一節中描述的 logcat 輸出。

您可以從 Firebase 控制台的事件信息中心訪問這些數據。此儀表板顯示為您的應用記錄的每種不同類型的事件自動創建的事件報告。