了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

記錄事件

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

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

在你開始之前

在使用Google Analytics之前，您需要：

  • 註冊您的 Unity 項目並將其配置為使用 Firebase。

    • 如果您的 Unity 項目已經使用 Firebase，那麼它已經針對 Firebase 進行了註冊和配置。

    • 如果您沒有 Unity 項目，可以下載示例應用程序。

  • 將Firebase Unity SDK （特別是FirebaseAnalytics.unitypackage ）添加到您的 Unity 項目。

請注意，將 Firebase 添加到您的 Unity 項目涉及Firebase 控制台和您打開的 Unity 項目中的任務（例如，您從控制台下載 Firebase 配置文件，然後將它們移動到您的 Unity 項目中）。

記錄事件

初始化Firebase.Analytics.FirebaseAnalytics模塊後，您可以使用它通過LogEvent()方法記錄事件。

為幫助您入門，Analytics SDK 定義了一些建議事件，這些事件在不同類型的應用程序中很常見，包括零售和電子商務、旅遊和遊戲應用程序。要詳細了解這些事件以及何時使用它們，請瀏覽 Firebase 幫助中心中的事件和屬性文章。

您可以在以下位置找到建議事件類型的實施細節：

  • 建議的事件：請參閱Event常量列表。
  • 規定的參數：參見Parameters常量列表。

以下示例演示如何記錄建議的SELECT_CONTENT事件：

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

  • 自定義參數：自定義參數不會直接顯示在您的 Analytics 報告中，但它們可以用作可應用於每個報告的受眾定義中的過濾器。如果您的應用鏈接到BigQuery 項目，則自定義參數也包含在導出到 BigQuery 的數據中。

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

如果您的應用程序具有建議的分析事件類型未涵蓋的特定需求，您可以記錄自己的自定義分析事件，如本例所示：

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

查看日誌輸出中的事件

安卓

您可以在 Android Studio 調試日誌中啟用詳細日誌記錄，以幫助驗證 SDK 是否正確記錄了事件。這包括自動和手動記錄的事件。

您可以使用一系列 adb 命令啟用詳細日誌記錄：

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

此命令在 Android Studio logcat 中顯示您的事件，幫助您立即驗證是否正在發送事件。

iOS+

事件記錄到控制台，可以在通過 XCode 運行應用程序時查看。

在儀表板中查看分析事件

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

要在 Firebase 控制台中訪問此數據：

  1. 在Firebase 控制台中，打開您的項目。
  2. 從菜單中選擇Analytics以查看 Analytics 報告儀表板。

事件選項卡顯示為您的應用程序記錄的每種不同類型的分析事件自動創建的事件報告。在 Firebase 幫助中心閱讀有關Analytics 報告儀表板的更多信息。