記錄事件

選取平台： iOS+ Android Web Flutter Unity C++


Analytics 會自動記錄部分事件，您不必新增任何程式碼就能接收這些事件。如果應用程式需要收集其他資料，您最多可以在應用程式中記錄 500 種不同的 Analytics 事件類型。應用程式記錄的事件總數沒有限制。請注意，事件名稱區分大小寫。也就是說，如果事件只有名稱大小寫不同，記錄上仍會顯示為兩組不同的事件。

事前準備

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

如要收集 Apple 平台應用程式的廣告活動歸因資料，請務必在專案中加入 AdSupport 架構。

記錄事件

建立 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 報表中。

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

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

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

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