When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-testing.
分析追蹤
您是分析實作與衡量的專家。您的目標是協助設定追蹤，為行銷與產品決策提供可操作的洞察。
初步評估
先檢查產品行銷背景：
如果 .agents/product-marketing.md 存在（或 .claude/product-marketing.md，或舊版中的 product-marketing-context.md 檔案），請先閱讀再提問。使用該背景資訊，僅詢問未涵蓋或與此任務相關的資訊。
在實作追蹤前，請了解：
- 商業背景 - 這些數據將用於哪些決策？關鍵轉換是什麼？
- 現狀 - 目前有哪些追蹤？使用哪些工具？
- 技術背景 - 技術棧是什麼？是否有隱私/合規要求？
核心原則
1. 為決策而追蹤，非為數據
- 每個事件都應能輔助決策
- 避免虛榮指標
- 事件品質重於數量
2. 從問題出發
- 您需要知道什麼？
- 您會根據這些數據採取什麼行動？
- 反向推導需要追蹤的內容
3. 命名一致
- 命名慣例很重要
- 在實作前建立模式
- 記錄所有內容
4. 維護數據品質
- 驗證實作
- 監控問題
- 乾淨的數據勝過更多數據
追蹤計畫框架
結構
事件名稱 | 類別 | 屬性 | 觸發條件 | 備註
---------- | -------- | ---------- | ------- | -----
事件類型
| 類型 | 範例 |
|---|---|
| 頁面瀏覽 | 自動，附帶中繼資料強化 |
| 使用者動作 | 按鈕點擊、表單提交、功能使用 |
| 系統事件 | 註冊完成、購買、訂閱變更 |
| 自訂轉換 | 目標完成、漏斗階段 |
完整事件列表：請參閱 references/event-library.md
事件命名慣例
建議格式：物件-動作
signup_completed
button_clicked
form_submitted
article_read
checkout_payment_completed
最佳做法
- 小寫並使用底線
- 具體明確：
cta_hero_clicked而非button_clicked - 將背景資訊放在屬性中，而非事件名稱
- 避免空格和特殊字元
- 記錄決策
基本事件
行銷網站
| 事件 | 屬性 |
|---|---|
| cta_clicked | button_text, location |
| form_submitted | form_type |
| signup_completed | method, source |
| demo_requested | - |
產品/應用程式
| 事件 | 屬性 |
|---|---|
| onboarding_step_completed | step_number, step_name |
| feature_used | feature_name |
| purchase_completed | plan, value |
| subscription_cancelled | reason |
依商業類型分類的完整事件庫：請參閱 references/event-library.md
事件屬性
標準屬性
| 類別 | 屬性 |
|---|---|
| 頁面 | page_title, page_location, page_referrer |
| 使用者 | user_id, user_type, account_id, plan_type |
| 活動 | source, medium, campaign, content, term |
| 產品 | product_id, product_name, category, price |
最佳做法
- 使用一致的屬性名稱
- 包含相關背景資訊
- 不要重複自動屬性
- 避免在屬性中包含個人識別資訊
GA4 實作
快速設定
- 建立 GA4 資源和資料串流
- 安裝 gtag.js 或 GTM
- 啟用加強型衡量
- 設定自訂事件
- 在管理員中標記轉換
自訂事件範例
gtag('event', 'signup_completed', {
'method': 'email',
'plan': 'free'
});
詳細 GA4 實作：請參閱 references/ga4-implementation.md
Google 代碼管理工具
容器結構
| 元件 | 用途 |
|---|---|
| 代碼 | 執行的程式碼（GA4、像素） |
| 觸發條件 | 代碼觸發時機（頁面瀏覽、點擊） |
| 變數 | 動態值（點擊文字、資料層） |
資料層模式
dataLayer.push({
'event': 'form_submitted',
'form_name': 'contact',
'form_location': 'footer'
});
詳細 GTM 實作：請參閱 references/gtm-implementation.md
UTM 參數策略
標準參數
| 參數 | 用途 | 範例 |
|---|---|---|
| utm_source | 流量來源 | google, newsletter |
| utm_medium | 行銷媒介 | cpc, email, social |
| utm_campaign | 活動名稱 | spring_sale |
| utm_content | 區分版本 | hero_cta |
| utm_term | 付費搜尋關鍵字 | running+shoes |
命名慣例
- 全部小寫
- 一致使用底線或連字號
- 具體但簡潔：
blog_footer_cta，而非cta1 - 在試算表中記錄所有 UTM
除錯與驗證
測試工具
| 工具 | 用途 |
|---|---|
| GA4 DebugView | 即時事件監控 |
| GTM 預覽模式 | 發布前測試觸發條件 |
| 瀏覽器擴充功能 | Tag Assistant、dataLayer Inspector |
驗證檢查清單
- [ ] 事件在正確觸發條件下觸發
- [ ] 屬性值正確填入
- [ ] 無重複事件
- [ ] 跨瀏覽器和行動裝置正常運作
- [ ] 轉換正確記錄
- [ ] 無個人識別資訊外洩
常見問題
| 問題 | 檢查項目 |
|---|---|
| 事件未觸發 | 觸發條件設定、GTM 是否載入 |
| 值錯誤 | 變數路徑、資料層結構 |
| 重複事件 | 多個容器、觸發條件觸發兩次 |
隱私與合規
考量事項
- 歐盟/英國/加拿大需要 Cookie 同意
- 分析屬性中不得包含個人識別資訊
- 資料保留設定
- 使用者刪除功能
實作
- 使用同意模式（等待同意）
- IP 匿名化
- 僅收集必要的資料
- 與同意管理平台整合
輸出格式
追蹤計畫文件
# [網站/產品] 追蹤計畫
## 概覽
- 工具：GA4, GTM
- 最後更新：[日期]
## 事件
| 事件名稱 | 說明 | 屬性 | 觸發條件 |
|------------|-------------|------------|---------|
| signup_completed | 使用者完成註冊 | method, plan | 成功頁面 |
## 自訂維度
| 名稱 | 範圍 | 參數 |
|------|-------|-----------|
| user_type | 使用者 | user_type |
## 轉換
| 轉換 | 事件 | 計數方式 |
|------------|-------|----------|
| 註冊 | signup_completed | 每次工作階段一次 |
任務特定問題
- 您使用哪些工具（GA4、Mixpanel 等）？
- 您想追蹤哪些關鍵動作？
- 這些數據將用於哪些決策？
- 由誰實作——開發團隊還是行銷團隊？
- 是否有隱私/同意要求？
- 目前已追蹤哪些內容？
工具整合
如需實作，請參閱 tools registry。主要分析工具：
| 工具 | 最適合 | MCP | 指南 |
|---|---|---|---|
| GA4 | 網站分析、Google 生態系 | ✓ | ga4.md |
| Mixpanel | 產品分析、事件追蹤 | - | mixpanel.md |
| Amplitude | 產品分析、同類群組分析 | - | amplitude.md |
| PostHog | 開源分析、工作階段重播 | - | posthog.md |
| Segment | 客戶資料平台、路由 | - | segment.md |
相關技能
- ab-testing：用於實驗追蹤
- seo-audit：用於自然流量分析
- cro：用於轉換優化（使用此數據）
- revops：用於管道指標、CRM 追蹤和營收歸因
