Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now

記錄事件

本指南說明如何在應用程序中記錄事件。

事件提供了有關您的應用程序中發生的情況的洞察力,例如用戶操作,系統事件或錯誤。

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

在你開始之前

確保已設置項目,並且可以按照Analytics(分析)入門中所述訪問Analytics (分析)

記錄事件

配置FirebaseApp實例後,可以開始使用logEvent()方法記錄事件。

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

您可以在SwiftObjective-C的常量參考中找到實現細節。

以下示例演示瞭如何記錄建議的kFIRSelectContent事件:

迅速

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

物鏡

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

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

  • 自定義參數:可以在Google Analytics(分析)報告中註冊自定義參數以進行報告。它們還可以用作可應用於每個報告的受眾群體定義中的過濾器。如果您的應用程序鏈接到BigQuery項目,則自定義參數也會包含在導出到BigQuery的數據中。

  • kFIRParameterValue參數: kFIRParameterValue是通用參數,可用於累積與事件有關的關鍵指標。示例包括收入,距離,時間和點數。

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

迅速

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

物鏡

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

設置默認事件參數

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

迅速

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

物鏡

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

如果在logEvent()方法中指定了參數,則使用該值代替默認值。

要清除默認參數,請調用setDefaultEventParameters方法,並將參數設置為nil

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

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

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

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

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

在儀表板中查看事件

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

您可以從Firebase控制台中的“事件”儀表板訪問此數據。此儀表板顯示事件報告,這些報告是為應用程序記錄的每種不同類型的事件自動創建的。