記錄事件


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

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

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

事前準備

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

記錄事件

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

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

您可以在 SwiftObjective-C

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

Swift

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 中 報表。方法如下: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,
])

Objective-C

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

設定預設事件參數

您可以使用以下項目,記錄多個事件的參數: 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這個資訊主頁會顯示事件報表 系統會根據記錄到的每種事件類型,