Catch up on everything we announced at this year's Firebase Summit. Learn more

記錄事件

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

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

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

在你開始之前

請確保您已經設置了您的項目,如描述可以訪問Analytics(分析)獲取與分析開始

記錄事件

如果已經配置了firebase.analytics()情況下,你就可以開始記錄事件與logEvent()方法。如果你已經很熟悉谷歌Analytics(分析),這個方法等同於使用event的命令gtag.js

為了幫助您入門,Analytics SDK 定義了許多在不同類型的應用程序(包括零售和電子商務、旅遊和遊戲應用程序)中常見的建議事件。要了解更多有關這些事件和何時使用它們,瀏覽事件和屬性在火力地堡幫助中心文章。

注:為了獲得最大的詳細報告,記錄建議的事件對你的應用程序和他們的指定參數才有意義。這也可確保您在最新的 Google Analytics(分析)功能可用時受益。

你可以找到實現細節的幾個事件以及它們在參數gtag.js事件引用

下面的例子演示了如何登錄一個select_content事件:

網頁版 9

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

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

網頁版 8

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

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

  • 自定義參數:自定義參數可以登記在Analytics報告中報告。它們也可以用作過濾器的觀眾定義,可以應用到每一個報告。自定義的參數也包含在數據導出到BigQuery的,如果您的應用程序鏈接到的BigQuery項目。
  • value參數: value是一個通用的參數,其用於累積的關鍵度量涉及的事件是有用的。示例包括收入、距離、時間和積分。

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

網頁版 9

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

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

網頁版 8

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

在儀表板中查看事件

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

您可以從訪問這些數據事件在火力地堡控制台儀表板。此儀表板顯示為您的應用程序記錄的每種不同類型的事件自動創建的事件報告。