建立 GA4 事件時，難免會遇到「加強型事件」、「自動事件」和「建議事件」都無法滿足的狀況，這時就需要使用「自訂事件」建立指定的事件名稱和回傳值來處理需求，這篇教學會介紹使用 Google 代碼 ( gtag.js ) 建立自訂事件。

原文參考：自訂事件

自訂事件格式

建立自訂事件，需要使用 gtag.js API 裡的 gtag() 函式，程式碼寫法如下：

gtag('event', '<event_name>', {
  <event_parameters>
});

當該函式執行後，會使觸發下列事件行為：

• 用 event 指令會告知 Google 正在傳送事件
• 傳送 <event_name> ( 事件名稱 )。
• 傳送一至多組的 <event_parameters> ( 參數名稱 key 與值 value )。

自訂事件規則與限制 {a2}

建立 GA4 自訂事件時，事件名稱需要符合相關命名規則 ( 參考：建立事件 )。：

• 事件名稱須區分大小寫，例如 my_event 和 My_Event 是兩個不同事件。
• 事件名稱開頭必須是英文字母，名稱只能以英文字母、數字和底線構成，不可包含空格。
• 事件名稱可包含英文和非英文的字詞及字母。
• 事件名稱不要使用保留的前置字元和事件名稱 ( 自動收集事件、加強型事件、建議事件 )。

此外，事件名稱或參數名稱與內容，也有下列使用上限，Google Analytics 官方表示不會紀錄超過限制的事件、參數或值，甚至會出現錯誤代碼訊息，因此在使用上需要多加注意 ( 參考：GA4 事件收集限制 )。

gtag.js 安裝自訂事件

如果是使用 gtag.js，可以在要觸發事件的程式碼裡，加上類似下方的程式碼，下方的程式碼會傳送 ( 觸發 ) 一個名為 oxxo 的自訂事件，並傳送兩個參數。

gtag('event', 'oxxo', {
  'my_name': 'oxxo.studio',
  'my_age': '18'
});

觸發自訂事件後，從「即時」報表裡可以看見傳送的事件 ( 詳細報表需要等待 24～36 小時 )。

GTM 安裝自訂事件

如果是使用 GTM，可以參考「GTM 加入 GA4 事件代碼」教學，新增一個名為 oxxo 的 GA4 事件代碼，當中包含 my_name 和 my_age 兩個參數。

發布 GTM 代碼後，回到執行的網頁，在觸發自訂事件後，從「即時」報表裡可以看見傳送的事件 ( 詳細報表需要等待 24～36 小時 )。

更多教學

大家好，我是 OXXO，是個即將邁入中年的斜槓青年，我有個超過一千篇教學的 STEAM 教育學習網，有興趣可以參考下方連結呦～ ^_^

• Python 教學 ( 學習導讀 )
• Scratch 教學
• GA4 ( Google Analytics 4 ) 教學
• 生成式 AI ( AIGC ) 教學
• Midjourney 教學
• HTML 教學