記錄事件


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

事件可讓您深入瞭解應用程式情況，例如使用者 動作、系統事件或錯誤等

Analytics 會自動記錄部分活動記錄 事件；你不是 必須新增任何程式碼才能接收代碼。如果您的應用程式需要收集 資料中，您最多可以在應用程式中記錄 500 種不同的 Analytics 事件類型。 應用程式記錄的事件總數沒有上限。請注意， 名稱有大小寫之分，且記錄的兩個事件名稱只有 會導致兩個不同的事件。

事前準備

請確認您已設定專案，且可使用以下身分存取 Analytics： 描述 開始使用 Analytics。

記錄事件

設定 FirebaseApp 執行個體後，即可開始記錄 ，其中包含 logEvent() 方法。

為協助您快速上手，Analytics SDK 會定義 不同類型的應用程式所通用的建議事件，包括 零售業、電子商務、旅遊和遊戲應用程式瞭解詳情 關於這些事件 以及使用時機，請參閱「建議事件」一文。

您可以在 Swift 和 Objective-C。

下列範例說明如何記錄 kFIRSelectContent 個事件：

Swift

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

Objective-C

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

除了規定的參數外，您還可以新增下列參數 附加至任何事件：

  • 自訂參數：自訂參數可當成 維度或指標 在 Analytics 份報表中。 自訂維度適用於非數值事件參數資料， 自訂任何參數資料的自訂指標一次 您已使用 SDK 記錄自訂參數，請登錄該維度或 並確保這些自訂參數會顯示在 Analytics 中 報表。方法如下：Analytics >事件 >管理自訂定義 > 建立自訂維度

    自訂參數可用於 目標對象 可套用至每份報表的定義 資料也會包含自訂參數 匯出至 BigQuery 如果您的應用程式已連結至 BigQuery 專案尋找範例查詢和更多內容 前往「Google Analytics 4 BigQuery Export」一文。

  • kFIRParameterValue 參數：kFIRParameterValue 是一般用途參數，適合用來累積重點指標 特定事件的新訊例如收益、距離、時間及 點。

如果您的應用程式不符合建議項目中的特定需求 事件類型也可以記錄自訂事件，如以下範例所示：

Swift

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

Objective-C

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

設定預設事件參數

您可以使用以下項目，記錄多個事件的參數： setDefaultEventParameters。 預設參數會與記錄的所有未來事件建立關聯。

和自訂參數一樣，請登錄預設事件參數，確保這些參數 自訂參數會顯示在 Analytics 報表中

Swift

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

目標-C

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

如果 logEvent()敬上 方法，便會使用該值而非預設值。

如要清除預設參數，請呼叫 setDefaultEventParameters敬上 方法，並將參數設為 nil。

在 Xcode 偵錯控制台中查看事件

您可以啟用詳細記錄功能來監控 SDK 的事件記錄， 確認事件記錄是否正確。這包括 以及手動記錄的事件

您可以按照下列方式啟用詳細記錄功能：

  1. 在 Xcode 中，選取 [Product] (產品) > 配置 >編輯配置...
  2. 選取左選單中的「執行」。
  3. 選取「Arguments」分頁標籤。
  4. 在「傳遞時通過的引數」部分，新增 -FIRAnalyticsVerboseLoggingEnabled。

下次執行應用程式時，事件會顯示在 Xcode 偵錯中 控制台，讓您立即確認事件正在傳送。

在資訊主頁中查看事件

您可以在「 Firebase 個控制台資訊主頁。這些資訊主頁會定期更新 整天下來。如要立即測試，請使用 Logcat 輸出內容， 請參閱上一節的說明

如要存取這類資料，請前往 事件 數據。Firebase這個資訊主頁會顯示事件報表 系統會根據記錄到的每種事件類型，