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

記錄事件

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

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

在你開始之前

之前,你可以使用谷歌Analytics(分析) ,您需要:

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

    • 如果您的 Unity 項目已經使用 Firebase,那麼它已經為 Firebase 註冊和配置。

    • 如果你沒有一個統一的項目,你可以下載一個示例應用程序

  • 添加火力地堡統一SDK (具體FirebaseAnalytics.unitypackage )到您的統一項目。

注意添加火力地堡到您的統一項目涉及雙方的任務火力地堡控制台並在打開的統一的項目(例如,您從控制台下載火力地堡的配置文件,然後將其移動到您的統一項目)。

記錄事件

你已經初始化後Firebase.Analytics.FirebaseAnalytics模塊,你可以用它來記錄事件與LogEvent()方法。

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

您可以在以下位置找到建議的事件類型的實施詳細信息:

  • 推薦活動:見列表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. 火力地堡控制台,打開您的項目。
  2. 從菜單中選擇Analytics(分析)來查看分析報告儀表板。

事件選項卡顯示事件報告自動為每個不同類型的分析事件的記錄創建您的應用。了解更多關於Analytics(分析)報告信息中心在火力地堡幫助中心。