本指南向您展示如何在應用程序中記錄事件。
事件可讓您深入了解應用程序中發生的情況,例如用戶操作、系統事件或錯誤。
Analytics 會自動為您記錄一些事件;您無需添加任何代碼即可接收它們。如果您的應用程序需要收集其他數據,您可以在應用程序中記錄最多 500 個不同的分析事件類型。您的應用程序記錄的事件總量沒有限制。請注意,事件名稱區分大小寫,並且記錄名稱僅大小寫不同的兩個事件會導致兩個不同的事件。
在你開始之前
確保您已設置項目並可以訪問 Analytics,如Analytics 入門中所述。
記錄事件
配置FirebaseApp
實例後,您可以開始使用logEvent()
方法記錄事件。
為了幫助您入門,Analytics SDK 定義了許多不同類型應用程序(包括零售和電子商務、旅遊和遊戲應用程序)中常見的推薦事件。要了解有關這些事件以及何時使用它們的更多信息,請參閱推薦事件。
您可以在Swift和Objective-C的常量參考中找到實現細節。
以下示例演示如何記錄推薦的kFIRSelectContent
事件:
迅速
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
除了規定的參數之外,您還可以將以下參數添加到任何事件:
自定義參數:自定義參數可用作Analytics 報告中的維度或指標。您可以將自定義維度用於非數字事件參數數據,並將自定義指標用於更好地以數字表示的任何參數數據。使用 SDK 記錄自定義參數後,請註冊維度或指標以確保這些自定義參數顯示在 Analytics 報告中。通過以下方式執行此操作:分析 > 事件 > 管理自定義定義 > 創建自定義維度
自定義參數可用於受眾定義,並可應用於每個報告。如果您的應用鏈接到 BigQuery 項目,自定義參數也會包含在導出到 BigQuery 的數據中。在Google Analytics 4 BigQuery Export中查找示例查詢及更多內容。
kFIRParameterValue
參數:kFIRParameterValue
是通用參數,可用於累積與事件相關的關鍵指標。示例包括收入、距離、時間和積分。
如果您的應用程序具有推薦事件類型未涵蓋的特定需求,您可以記錄自己的自定義事件,如下例所示:
迅速
Analytics.logEvent("share_image", parameters: [ "name": name as NSObject, "full_text": text as NSObject, ])
Objective-C
[FIRAnalytics logEventWithName:@"share_image" parameters:@{ @"name": name, @"full_text": text }];
設置默認事件參數
您可以使用setDefaultEventParameters
記錄事件中的參數。默認參數與記錄的所有未來事件相關聯。
與自定義參數一樣,註冊默認事件參數以確保這些自定義參數出現在 Analytics 報告中。
迅速
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Objective-C
[FIRAnalytics setDefaultEventParameters:
@{
@"level_name": "Caverns01",
@"level_difficulty": @(4)
}];
如果在logEvent()
方法中指定了參數,則使用該值而不是默認值。
要清除默認參數,請調用setDefaultEventParameters
方法並將參數設置為nil
。
在 Xcode 調試控制台中查看事件
您可以啟用詳細日誌記錄以監視 SDK 的事件記錄,以幫助驗證事件是否已正確記錄。這包括自動和手動記錄的事件。
您可以按如下方式啟用詳細日誌記錄:
- 在 Xcode 中,選擇“產品”>“方案”>“編輯方案...”
- 從左側菜單中選擇運行。
- 選擇參數選項卡。
- 在“啟動時傳遞的參數”部分中,添加
-FIRAnalyticsVerboseLoggingEnabled
。
下次運行應用程序時,您的事件將顯示在 Xcode 調試控制台中,幫助您立即驗證事件是否正在發送。
在儀表板中查看事件
您可以在 Firebase 控制台儀表板中查看有關事件的匯總統計信息。這些儀表板全天定期更新。要立即進行測試,請使用上一節中所述的 logcat 輸出。
您可以從 Firebase 控制台中的事件儀表板訪問此數據。此儀表板顯示為應用程序記錄的每種不同類型的事件自動創建的事件報告。