事件可讓您深入了解應用程式中發生的情況,例如使用者操作、系統事件或錯誤。
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 控制台中存取此資料:
- 在Firebase 控制台中,開啟您的專案。
- 從選單中選擇“分析”以查看“分析”報告儀表板。
「事件」標籤顯示為您的應用程式記錄的每種不同類型的 Analytics 事件自動建立的事件報告。閱讀有關儀表板的更多資訊。