更新時間：2025年1月8號
在GA4中，事件是資料收集的核心，而事件參數則是用來補充事件資訊的重要元素。
透過事件參數，你可以了解使用者觸發事件時的詳細內容，例如點擊了哪個按鈕、哪個Banner、購買了什麼商品等資訊，讓數據分析更加精準。
本文將完整介紹GA4事件參數的概念、類型、限制以及自訂事件參數的註冊方法。
什麼是事件參數？
事件參數（Event Parameters）是用來描述或區分事件的附加資訊。
在GA4中，每個事件主要由兩個部分組成：
- 事件名稱
- 事件參數
例如：
| 項目 | 值 |
|---|---|
| 事件名稱 | click_banner |
| 事件參數 | banner_name=Banner1 |
當使用者點擊不同廣告版位時，可以透過事件參數區分：
- Banner1
- Banner2
- Banner3
因此即使使用同一個事件名稱，也能知道使用者實際點擊的是哪一個廣告位置。
為什麼事件參數很重要？
如果沒有事件參數，你只能知道：有人觸發了click_banner事件。
但無法知道：
- 點擊的是哪個Banner
- 點擊的是首頁還是產品頁
- 點擊的是哪個商品
因此事件參數是GA4進行精細化分析的重要基礎。
GA4事件參數的分類
GA4的事件參數可分為兩種類型：
- 预设参数：預設參數是GA4自動收集的參數，不需要額外設定。
- 自订参数：自訂參數就是使用者可以自訂
预设参数
預設參數是GA4自動收集的參數，不需要額外設定。
網站資料串流預設參數
網站預設包含以下參數：
| 參數名稱 | 說明 | 長度限制 |
|---|---|---|
language |
瀏覽器語言 | 無特別限制 |
page_location |
目前頁面 URL | 最多 1,000 個半形字元 |
page_referrer |
來源網址（Referrer URL） | 最多 420 個半形字元 |
page_title |
頁面標題 | 最多 300 個半形字元 |
screen_resolution |
瀏覽器解析度 | 無特別限制 |
App資料串流預設參數
如果是 App（Firebase）資料串流，則常見預設參數包括：
| 參數名稱 | 說明 |
|---|---|
| app_version | App 版本號 |
| firebase_screen_id | 畫面 ID |
| firebase_screen_class | 畫面類別 |
自訂事件參數
當預設參數無法滿足分析需求時，可以自行建立自訂事件參數。
例如：
- 商品顏色（color）
- 會員等級（member_level）
- 按鈕位置（button_position）
- Banner 名稱（banner_name）
這些都屬於自訂事件參數。
GA4自訂事件參數可分為：
- 文本參數
- 數值參數
文字型參數
文字型參數需註冊為：事件層級自訂維度（Event-scoped Custom Dimension）
如：
| 參數名稱 | 值 |
|---|---|
| color | red |
| member_level | VIP |
| banner_name | Homepage Banner |
限額註冊50個，數值長度不超過100個半形字元
數值型參數
數值型參數需註冊為：事件層級自訂指標（Event-scoped Custom Metric）
如：
| 參數名稱 | 值 |
|---|---|
| click_value | 100 |
| score | 85 |
| quantity | 3 |
限額註冊50個，數值長度不超過100個半形字元
GA4事件參數的限制
GA4規定：
每個事件最多可攜帶25個事件參數。
此限制包含預設參數和自訂參數
如：事件已經自動待入page_location、page_title、language，再加上自訂參數後，總數不能超過25個。
自訂定義有註冊上限
| 類型 | 上限 |
|---|---|
| 自訂維度 | 50 個 |
| 自訂指標 | 50 個 |
如果超過上限，就無法再建立新的自訂定義。
如何規劃事件參數？
由於自訂定義數量有限，建議在規劃時遵循以下原則。
原則 1：優先使用預設參數
如果GA4已經提供預設參數，就不需要另外建立自訂參數。
例如：page_title、page_location、language，這些資訊都已自動收集。
原則 2：不同事件盡量共用相同參數
假設：
- 事件A有事件參數product_name、category、price
- 事件B有事件參數product_name、category、quantity
則只需註冊product_name、category、price、quantity這4個，而不是因事件不同就建立重複的參數名稱。
這樣能有效節省自訂維度與自訂指標額度。
如何註冊自訂事件參數？
假設網站送出以下事件：
dataLayer.push({
event: "datalayer_push",
color: "red",
click_value: 100
});
其中：
- color 為文字型參數
- click_value 為數值型參數
需要分別註冊。
註冊自訂維度
以color為例，在GA4中，點擊「管理」——「資源設定」——「資料顯示」——「自訂定義」——「建立自訂維度」, 然後做如下設定：
註冊自訂指標
以click_value為例，在GA4中，點擊「管理」——「資源設定」——「資料顯示」——「自訂定義」——「自訂指標」——「建立自訂指標」, 然後做如下設定：
自訂參數多久會出現在報表？
這是許多GA4初學者最常遇到的問題。
建立自訂維度或自訂指標後：
通常需要等待約24小時，資料才會開始出現在報表與探索中。
因此若剛建立完成後看不到資料，屬於正常現象。
可以先透過 Tag Assistant 或 DebugView，確認事件與參數是否已正確送出。
總結
事件參數是GA4事件模型的重要組成部分，用來補充事件的詳細資訊。
在規劃事件追蹤時，需特別注意：
- 每個事件最多25個參數
- 自訂維度最多50個
- 自訂指標最多50個
- 優先使用GA4預設參數
- 盡量讓多個事件共用相同參數
良好的事件參數規劃，不僅能提升報表分析效率，也能避免未來因額度不足而需要重新設計追蹤架構。