記錄事件

選取平台： iOS+ Android 網頁 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。