event-tracking-skill

為什麼要用

核心特性

自動化網站分析以推斷追蹤需求
符合 GA4 規範的事件結構生成
透過 Tag Manager API 同步 GTM 容器
發佈前的預覽驗證
一鍵發佈標籤容器版本
跨 AI 代理相容

即時演示

實際使用效果

event-tracking-skill.replay ▶ 就緒

0/0

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法： event-tracking-skill

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

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

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

步驟

掃描網站

Scan https://example.com and propose a GA4 event schema (page_view, view_item, add_to_cart, etc.).✓ 已複製

→ 包含參數與範例 payload 的事件清單
同步至 GTM

Sync this schema into GTM container GTM-ABCDEF as tags + triggers + variables.✓ 已複製

→ 回報工作區變更內容
預覽與驗證

Open Preview on staging.example.com and verify each event fires.✓ 已複製

→ 每個事件的觸發／未觸發報告
發佈

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

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

步驟

推斷商品事件

Scan /shop and /checkout and propose the full GA4 ecommerce event list.✓ 已複製

→ 包含 items[] 參數的 view_item_list、view_item、add_to_cart、begin_checkout、purchase 事件
設定 dataLayer 推送模式

Generate JS snippets to push each event from our React components.✓ 已複製

→ 每個事件對應的 dataLayer.push 程式碼片段
接入 GTM

Create the matching GA4 tags and triggers in GTM.✓ 已複製

→ 標籤已與 dataLayer 事件連結

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

搭配使用： ecommerce-skill

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

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

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

步驟

匯出容器現況

Read GTM container GTM-XXXX and list every active tag, trigger, and variable.✓ 已複製

→ 標準化的清單目錄
與網站現況比對

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

服務帳號擁有容器編輯權限。請將權限範圍限定在單一容器，而非整個 GCP 組織。
發佈步驟會直接影響線上網站。務必先在預覽模式驗證無誤後再執行發佈。

故障排查

常見錯誤與修復

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

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

替代方案