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

記錄事件

本指南向您展示如何在您的應用程序中記錄事件。

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

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

在你開始之前

請確保您已經設置了您的項目,如描述可以訪問Analytics(分析)獲取與分析開始

記錄事件

如果已經配置了FirebaseApp情況下,你就可以開始記錄事件與logEvent()方法。

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

你可以在為常量參考實施細則斯威夫特Objective-C的

下面的例子演示了如何登錄建議kFIRSelectContent事件:

迅速

注:本產品火力地堡上沒有MacOS的目標。
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

目標-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

除了規定的參數外,您還可以向任何事件添加以下參數:

  • 自定義參數:自定義參數可以登記在Analytics報告中報告。它們也可以用作過濾器的觀眾定義,可以應用到每一個報告。自定義的參數也包含在數據導出到BigQuery的,如果您的應用程序鏈接到的BigQuery項目。

  • kFIRParameterValue參數: kFIRParameterValue是一個通用的參數,其用於累積的關鍵度量涉及的事件是有用的。示例包括收入、距離、時間和積分。

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

迅速

注:本產品火力地堡上沒有MacOS的目標。
Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

目標-C

 [FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

設置默認事件參數

您可以在使用事件日誌參數setDefaultEventParameters 。默認參數與記錄的所有未來事件相關聯。

迅速

注:本產品火力地堡上沒有MacOS的目標。
Analytics.setDefaultEventParameters([ "level_name": "Caverns01", "level_difficulty": 4 ])

目標-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

如果參數是在中的指定logEvent()方法,則使用該值而不是默認的。

要清除默認參數,調用setDefaultEventParameters方法與參數設置到nil

在 Xcode 調試控制台中查看事件

您可以啟用詳細日誌記錄來監控 SDK 的事件日誌記錄,以幫助驗證事件是否被正確記錄。這包括自動和手動記錄的事件。

您可以按如下方式啟用詳細日誌記錄:

  1. 在Xcode中,選擇產品>方案>編輯方案...
  2. 從左邊的菜單中選擇運行
  3. 選擇參數選項卡。
  4. 傳遞在啟動部分的參數,添加-FIRAnalyticsDebugEnabled

下次運行應用程序時,您的事件將顯示在 Xcode 調試控制台中,幫助您立即驗證是否正在發送事件。

在儀表板中查看事件

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

您可以從訪問這些數據事件在火力地堡控制台儀表板。此儀表板顯示為您的應用程序記錄的每種不同類型的事件自動創建的事件報告。