Skip to content

建立 2024-09-01 更新 2026-09-13

事件追蹤

GA4 裡幾乎所有資料都是事件。這一頁說明事件有哪幾種、參數怎麼設計，以及用 gtag 或 GTM 怎麼送出。送出後一定要用 DebugView 對過名稱與參數，再考慮標成 關鍵事件。

四種事件

類型 誰負責 例子
自動收集 裝好代碼就有 first_visit、session_start、user_engagement
加強型評估 資料串流裡開關 page_view、scroll、file_download
建議事件 你發送，但用 Google 建議的名稱 purchase、sign_up、generate_lead
自訂事件 名稱與參數都自己定 cta_click、pricing_view

能用建議事件就不要自創同義名稱。purchase、sign_up 有官方參數規格，之後電商報表、廣告匯入才接得上去。完整清單見 GA4 建議事件。

自動收集與加強型評估不必再自己送一次，否則會重複。

命名與參數

事件名稱建議：小寫、底線分隔、看名稱就知道發生什麼事。

較好 較差 原因
generate_lead event1 名稱要能讀
cta_click Click_CTA_Button 大小寫混用，之後難篩選
sign_up register_ok 已有建議事件就用建議名稱

參數放「這一次」的細節，不要把能當參數的東西拆成一堆事件。例如不要同時做 cta_click_header 與 cta_click_footer，改成一個 cta_click，參數 cta_location 為 header 或 footer。

gtag('event', 'cta_click', {
  cta_location: 'header',
  cta_text: '免費試用'
});

不要沿用 UA 的 category / label 當主架構

UA 習慣 event_category、event_action、event_label。GA4 以事件名稱 + 有意義的參數為主。除非要相容舊實作，否則請直接用 cta_location、item_id 這種看得懂的參數名。

參數若要出現在標準報表的維度選單，需到 管理 → 資料顯示 → 自訂定義 登記為自訂維度或指標。未登記時，DebugView 看得到，多數標準報表選不到。每個資源的自訂維度有名額上限，先留給真的會切片的欄位。

用 gtag 送事件

頁面已有 設置 GA4 的 gtag('config', ...) 之後，在行為發生時呼叫：

document.getElementById('signup-btn').addEventListener('click', function () {
  gtag('event', 'sign_up', {
    method: 'website_form'
  });
});

表單送出：

form.addEventListener('submit', function () {
  gtag('event', 'generate_lead', {
    form_id: 'contact',
    lead_source: 'footer'
  });
});

購買請用建議事件 purchase，並帶 value、currency 與 items，見 關鍵事件。

用 GTM 送事件

  1. 先確認已有「Google 代碼」且在所有頁面觸發。
  2. 新增代碼，類型選 Google Analytics：GA4 事件。
  3. 設定代碼選剛才的 Google 代碼（或填同一個評估 ID）。
  4. 事件名稱填 cta_click（不要用中文、不要空白）。
  5. 事件參數加列，例如 cta_location、cta_text；值可用 GTM 變數。
  6. 觸發條件用「點擊 - 所有元素」或「點擊 - 僅連結」，並限制 CSS 選擇器或按鈕 ID。
  7. 先 預覽，確認代碼觸發且參數值正確，再發布。

GTM 預覽只證明「標籤有開火」。GA4 有沒有收到，仍以 DebugView 為準。

用 DebugView 驗收

  1. 用 Tag Assistant 連到網站，或在瀏覽器安裝 GA Debugger，也可在事件加上 debug_mode: true。
  2. 到 GA4 管理 → DebugView（常見位置在資料顯示相關區塊）。
  3. 在網站做出該行為，左側時間軸應出現事件名稱。
  4. 點事件，核對參數名稱與值；不要只看「有事件」就結束。

即時報表能看事件名稱，但參數細節不如 DebugView 清楚。標準報表可能延遲數小時，不適合作驗收。

最小事件清單

還沒想清楚要追什麼時，先不要一次做 30 個自訂事件。多數網站先有這些就夠分析：

事件 類型 用途
page_view 加強型評估 看了哪一頁
scroll 加強型評估 是否看到頁尾
generate_lead 或表單送出 建議／自訂 留下名單
sign_up 建議 註冊成功
cta_click 自訂 重要按鈕（可選）
purchase 建議 完成付款（電商）

下一步：把真正影響業績的事件標成 關鍵事件。