/ 目錄 / 演練場 / event-tracking-skill
● 社群 jtrackingai ⚡ 即開即用

event-tracking-skill

作者 jtrackingai · jtrackingai/event-tracking-skill

GA4 + GTM 事件追蹤自動化——從網站分析、事件結構設計、GTM 同步、預覽驗證到發佈,全程由你的 AI 代理完成。

Event Tracking Skill 自動化完整的 GA4 事件追蹤工作流程:掃描網站、依據 GA4 規範提出事件結構、同步至 Google Tag Manager、在 GTM 預覽模式驗證,最後發佈。相容 Claude Code、Cursor 與 Codex。省去分析工作中重複繁瑣的部分。

為什麼要用

核心特性

即時演示

實際使用效果

event-tracking-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "event-tracking-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "event-tracking-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jtrackingai/event-tracking-skill",
          "~/.claude/skills/event-tracking-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add event-tracking-skill -- git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: event-tracking-skill

如何在新網站上從零開始設定 GA4 + GTM

👤 正在為新網站建立追蹤的行銷人員與全端開發者 ⏱ ~60 min intermediate

何時使用: 網站已上線、尚無任何追蹤,且有截止期限。

前置條件
  • 已安裝 Skill — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • GA4 資源 + GTM 容器 — 在 Google Tag Manager 中建立;記下 GTM-XXXXXX ID
  • 具有 Tag Manager API 存取權限的服務帳號 — GCP 主控台 → 啟用 Tag Manager API → 下載服務帳號 JSON
步驟
  1. 掃描網站
    Scan https://example.com and propose a GA4 event schema (page_view, view_item, add_to_cart, etc.).✓ 已複製
    → 包含參數與範例 payload 的事件清單
  2. 同步至 GTM
    Sync this schema into GTM container GTM-ABCDEF as tags + triggers + variables.✓ 已複製
    → 回報工作區變更內容
  3. 預覽與驗證
    Open Preview on staging.example.com and verify each event fires.✓ 已複製
    → 每個事件的觸發/未觸發報告
  4. 發佈
    Publish version with notes 'initial GA4 setup'.✓ 已複製
    → 回傳已上線的版本 ID

結果: 在一小時內完成 GA4 追蹤設定,事件資料正常流入。

注意事項
  • 事件已觸發但 GA4 中 24 小時內看不到資料 — 測試期間改用 GA4 的 DebugView 進行即時驗證
  • GTM 工作區與手動編輯產生衝突 — 為此 Skill 的變更建立專屬工作區,避免與他人的修改互相干擾
搭配使用: seo-audit-skill

在既有網站上疊加 GA4 電商事件

👤 已使用 GA4 但缺少 purchase/view_item 追蹤的電商業者 ⏱ ~45 min intermediate

何時使用: 基本追蹤已存在,但電商漏斗資料仍是空白。

步驟
  1. 推斷商品事件
    Scan /shop and /checkout and propose the full GA4 ecommerce event list.✓ 已複製
    → 包含 items[] 參數的 view_item_list、view_item、add_to_cart、begin_checkout、purchase 事件
  2. 設定 dataLayer 推送模式
    Generate JS snippets to push each event from our React components.✓ 已複製
    → 每個事件對應的 dataLayer.push 程式碼片段
  3. 接入 GTM
    Create the matching GA4 tags and triggers in GTM.✓ 已複製
    → 標籤已與 dataLayer 事件連結

結果: GA4 中可見完整的電商漏斗資料。

搭配使用: ecommerce-skill

稽核既有 GTM 容器的追蹤覆蓋缺口

👤 接手雜亂 GTM 的分析師 ⏱ ~30 min advanced

何時使用: 你剛加入新團隊,GTM 是幾年前設定的,沒人清楚目前有哪些追蹤是啟用的。

步驟
  1. 匯出容器現況
    Read GTM container GTM-XXXX and list every active tag, trigger, and variable.✓ 已複製
    → 標準化的清單目錄
  2. 與網站現況比對
    Now scan the site and show which events fire in GTM Preview but aren't meaningful anymore, and which should exist but don't.✓ 已複製
    → 缺口清單與多餘項目清單

結果: 產出一份針對 GTM 工作區的清理 PR 清單。

組合

與其他 MCP 搭配,撬動十倍槓桿

event-tracking-skill + seo-audit-skill

SEO 稽核找出結構性問題,事件追蹤負責建立對應的量測

Run seo-audit, fix structural gaps, then event-tracking-skill for GA4 setup.✓ 已複製
event-tracking-skill + ecommerce-skill

電商 Skill 建立漏斗流程,事件追蹤負責埋設對應的追蹤

Use ecommerce-skill to redesign checkout, then event-tracking to wire purchase events.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
scan_site url 在進行任何 GTM 變更之前 Claude tokens
sync_gtm container_id, schema 事件結構審閱完成後 1+ Tag Manager API calls
preview_verify container_id, target_url 發佈前 0
publish_version container_id, notes 預覽驗證通過後 1 API call
audit_container container_id 接手既有 GTM 容器時 1+ API calls

成本與限制

運行它的成本

API 配額
GTM Tag Manager API:每位使用者每 100 秒 250 次請求;對手動設定情境而言相當充裕
每次呼叫 Token 數
完整設定約需 10-30k tokens
費用
免費(GA4 + GTM 均為免費服務)
提示
將掃描範圍限縮在 5-10 個關鍵頁面,避免爬取時間過長。

安全

權限、密鑰、影響範圍

憑證儲存: 服務帳號 JSON 存放於環境變數或檔案路徑。GTM 寫入所需權限範圍:tagmanager.edit.containers、tagmanager.publish。
資料出站: 網站掃描會讀取你的 URL;事件結構將被推送至 Google Tag Manager。
切勿授予: tagmanager.delete.containers

故障排查

常見錯誤與修復

401 Unauthorized on Tag Manager API

服務帳號尚未被加入為 GTM 容器的使用者。請至 GTM 管理員 → 使用者管理中新增。

驗證: curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
Preview shows events firing but GA4 DebugView is empty

GA4 設定標籤遺失,或傳送至錯誤的評估 ID。請再次確認設定標籤中的 G-XXXXXX 是否正確。

Published version rolls back changes

你發佈後,另一個工作區被後續發佈覆蓋。請合併兩個工作區的變更後重新發佈。

替代方案

event-tracking-skill 對比其他方案

替代方案何時用它替代權衡
Manual GTM setup需要 AI 無法安全生成的自訂邏輯時速度較慢,且更容易出錯

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills