記錄事件

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

Analytics 會自動記錄部分事件，您不需要新增任何程式碼即可接收這些事件。如果應用程式需要收集其他資料，您可以在應用程式中記錄最多 500 種 Analytics 事件類型。應用程式記錄的事件總量沒有上限。請注意，事件名稱有區分大小寫，如果記錄兩個只有名稱大小寫不同的事件，系統會將其視為兩個不同的事件。

事前準備

請確認您已設定專案，並且可以存取 Analytics，如「開始使用 Analytics」一文所述。

記錄事件

建立 FirebaseAnalytics 例項後，您可以使用該例項搭配程式庫的 log 方法記錄事件。

預先定義的事件

為協助您開始使用，Analytics SDK 定義了多項建議事件，這些事件適用於不同類型的應用程式，包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件，以及何時使用這些事件，請參閱「建議事件」一文。

您可以在 API 參考資料中找到建議事件類型的記錄方法。

以下範例說明如何記錄 select_content 事件：

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

或者，您也可以使用 logEvent() 記錄相同的事件：

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

如果您想指定規定 (必要) 參數以外的其他參數，這項功能就很實用。您可以在任何事件中加入下列參數：

自訂參數：自訂參數可用於Analytics 報表中的維度或指標。您可以使用自訂維度來呈現非數值的事件參數資料，並使用自訂指標來呈現任何以數字表示的參數資料。使用 SDK 記錄自訂參數後，請登錄維度或指標，確保這些自訂參數會顯示在 Analytics 報表中。方法是依序前往「Analytics」>「事件」>「管理自訂定義」>「建立自訂維度」。

您可以在目標對象定義中使用自訂參數，這些定義可套用至每份報表。如果應用程式已連結至 BigQuery 專案，則匯出至 BigQuery 的資料也會包含自訂參數。如要查看範例查詢和其他資訊，請參閱「Google Analytics 4 BigQuery Export」一文。
value 參數：通用參數，可用於累積與事件相關的重要指標。例如收益、距離、時間和分數。
參數名稱長度上限為 40 個半形字元，且必須以字母開頭，只能包含英數字元和底線。系統支援字串和數字類型。字串參數值的長度上限為 100 個半形字元。「firebase」、「google」和「ga_」前置字串為保留字串，不應用於參數名稱。

自訂事件

如果應用程式有特定需求，而建議的事件類型無法涵蓋這些需求，您可以記錄自訂事件，如下例所示：

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

設定預設事件參數

您可以使用 setDefaultEventParameters() 記錄各事件的參數。預設參數會與日後記錄的所有事件建立關聯。

如同自訂參數，請註冊預設事件參數，確保 Analytics 報表顯示這些參數。

有效的參數值為字串和數字。將鍵值設為 null 會清除該參數。傳入空值會清除所有參數。

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

如果在 logEvent() 或 log 方法中指定參數，系統會使用該值而非預設值。

如要清除預設參數，請呼叫 setDefaultEventParameters() 方法，並將參數設為 null。

在資訊主頁中查看事件

您可以在 Firebase 主控台資訊主頁中查看事件的匯總統計資料。這些資訊主頁會在一天中定期更新。如要立即測試，請按照上一節所述使用 logcat 輸出內容。

您可以透過 Firebase 主控台的「事件」資訊主頁存取這類資料。這個資訊主頁會顯示系統為應用程式記錄的每個不同類型事件自動建立的事件報表。