自訂事件

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

快速導覽：

• 自訂事件格式
• 自訂事件規則與限制
• gtag.js 安裝自訂事件
• GTM 安裝自訂事件

自訂事件格式

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

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

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

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

自訂事件規則與限制

建立 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 小時 )。

意見回饋

如果有任何建議或問題，可傳送「意見表單」給我，謝謝～