記錄事件

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

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 定義了許多不同類型應用程式(包括零售和電子商務、旅遊和遊戲應用程式)中常見的推薦事件。若要詳細了解這些事件以及何時使用它們,請參閱 Google Analytics(分析)說明中心的推薦事件文章。

您可以在以下位置找到推薦事件的實施詳細資訊:

  • 建議的事件:請參閱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 控制台儀表板中查看有關分析事件的總計統計資料。這些儀表板全天定期更新。若要立即進行測試,請使用上一節所述的 logcat 輸出。

要在 Firebase 控制台中存取此資料:

  1. Firebase 控制台中,開啟您的專案。
  2. 從選單中選擇“分析”以查看“分析”報告儀表板。

「事件」標籤顯示為您的應用程式記錄的每種不同類型的 Analytics 事件自動建立的事件報告。閱讀有關儀表板的更多資訊。