記錄事件

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

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

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

在你開始之前

確保您已設定專案並可以存取 Analytics,如Analytics 入門中所述。

記錄事件

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

為了幫助您入門,Analytics SDK 定義了許多不同類型應用程式(包括零售和電子商務、旅遊和遊戲應用程式)中常見的推薦事件。要了解有關這些事件以及何時使用它們的更多信息,請參閱推薦事件

您可以在SwiftObjective-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 的事件記錄,以協助驗證事件是否已正確記錄。這包括自動和手動記錄的事件。

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

  1. 在 Xcode 中,選擇“產品”>“方案”>“編輯方案...”
  2. 從左側選單中選擇運行
  3. 選擇參數選項卡。
  4. 「啟動時傳遞的參數」部分中,新增-FIRAnalyticsVerboseLoggingEnabled

下次執行應用程式時,您的事件將顯示在 Xcode 偵錯控制台中,可協助您立即驗證事件是否正在傳送。

在儀表板中查看事件

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

您可以從 Firebase 控制台中的事件儀表板存取此資料。此儀表板顯示為應用程式記錄的每種不同類型的事件自動建立的事件報告。