/ Каталог / Песочница / event-tracking-skill
● Сообщество jtrackingai ⚡ Сразу

event-tracking-skill

автор jtrackingai · jtrackingai/event-tracking-skill

GA4 + GTM event tracking automated — site analysis, event schema, GTM sync, preview verification, and publishing from your agent.

Event Tracking Skill automates the full GA4 event-tracking workflow: scan a site, propose an event schema aligned with GA4 conventions, sync to Google Tag Manager, verify in GTM Preview, and publish. Works across Claude Code, Cursor, and Codex. Removes the repetitive part of analytics work.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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

How to set up GA4 + GTM from zero on a new site

👤 Marketers and full-stack devs instrumenting a new site ⏱ ~60 min intermediate

Когда использовать: You have a site live, no tracking yet, and a deadline.

Предварительные требования
  • Skill installed — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • GA4 property + GTM container — Create in Google Tag Manager; note GTM-XXXXXX ID
  • Service account with Tag Manager API access — GCP console → enable Tag Manager API → service account JSON
Поток
  1. Scan the site
    Scan https://example.com and propose a GA4 event schema (page_view, view_item, add_to_cart, etc.).✓ Скопировано
    → Event list with parameters and sample payloads
  2. Sync to GTM
    Sync this schema into GTM container GTM-ABCDEF as tags + triggers + variables.✓ Скопировано
    → Workspace changes reported
  3. Preview and verify
    Open Preview on staging.example.com and verify each event fires.✓ Скопировано
    → Per-event fire/miss report
  4. Publish
    Publish version with notes 'initial GA4 setup'.✓ Скопировано
    → Live version ID returned

Итог: A GA4-tracked site with events flowing within an hour.

Подводные камни
  • Events fire but don't appear in GA4 for 24h — Use DebugView in GA4 for real-time verification while testing
  • GTM workspace conflicts with manual edits — Create a dedicated workspace for the skill's changes to avoid stepping on someone else
Сочетать с: seo-audit-skill

Layer GA4 ecommerce events onto an existing site

👤 Ecommerce operators already on GA4 but missing purchase/view_item tracking ⏱ ~45 min intermediate

Когда использовать: You have basic tracking but ecommerce funnels are empty.

Поток
  1. Infer product events
    Scan /shop and /checkout and propose the full GA4 ecommerce event list.✓ Скопировано
    → view_item_list, view_item, add_to_cart, begin_checkout, purchase with items[] param
  2. Configure dataLayer push patterns
    Generate JS snippets to push each event from our React components.✓ Скопировано
    → Per-event dataLayer.push snippet
  3. Wire in GTM
    Create the matching GA4 tags and triggers in GTM.✓ Скопировано
    → Tags linked to dataLayer events

Итог: Full ecommerce funnel visible in GA4.

Сочетать с: ecommerce-skill

Audit an existing GTM container for coverage gaps

👤 Analysts inheriting a messy GTM ⏱ ~30 min advanced

Когда использовать: You're on a new team; GTM was set up years ago; nobody knows what's live.

Поток
  1. Dump container state
    Read GTM container GTM-XXXX and list every active tag, trigger, and variable.✓ Скопировано
    → Normalized inventory
  2. Compare to site
    Now scan the site and show which events fire in GTM Preview but aren't meaningful anymore, and which should exist but don't.✓ Скопировано
    → Gap + cruft list

Итог: A cleanup PR list for your GTM workspace.

Комбинации

Сочетайте с другими MCP — эффект x10

event-tracking-skill + seo-audit-skill

SEO audit finds structural issues, event-tracking wires up measurement

Run seo-audit, fix structural gaps, then event-tracking-skill for GA4 setup.✓ Скопировано
event-tracking-skill + ecommerce-skill

Ecommerce skill sets up funnels, event-tracking instruments them

Use ecommerce-skill to redesign checkout, then event-tracking to wire purchase events.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
scan_site url Before any GTM changes Claude tokens
sync_gtm container_id, schema After schema is reviewed 1+ Tag Manager API calls
preview_verify container_id, target_url Before publish 0
publish_version container_id, notes After preview passes 1 API call
audit_container container_id Inheriting an existing GTM 1+ API calls

Стоимость и лимиты

Во что обходится

Квота API
GTM Tag Manager API: 250 req / 100s per user; generous for manual setup
Токенов на вызов
10-30k tokens per full setup
Деньги
Free (GA4 + GTM are free)
Совет
Scope scans to 5-10 key pages to avoid long crawls.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Service account JSON in env var or file path. GTM write scope: tagmanager.edit.containers, tagmanager.publish.
Исходящий трафик: Site scan reads your URLs; schema is pushed to Google Tag Manager.
Никогда не давайте: tagmanager.delete.containers

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized on Tag Manager API

Service account not added as a user on the GTM container. Add in GTM Admin → User Management.

Проверить: curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
Preview shows events firing but GA4 DebugView is empty

GA4 config tag missing or sending to wrong measurement ID. Double-check G-XXXXXX in the config tag.

Published version rolls back changes

Another workspace was published after yours. Reconcile both workspaces, merge, republish.

Альтернативы

event-tracking-skill в сравнении

АльтернативаКогда использоватьКомпромисс
Manual GTM setupYou need custom logic the LLM can't safely generateSlower, more error-prone

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills