/ Diretório / Playground / event-tracking-skill
● Comunidade jtrackingai ⚡ Instantâneo

event-tracking-skill

por 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.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

event-tracking-skill.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "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
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

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

O Continue usa um array de objetos de servidor em vez de um 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"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: 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

Quando usar: You have a site live, no tracking yet, and a deadline.

Pré-requisitos
  • 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
Fluxo
  1. Scan the site
    Scan https://example.com and propose a GA4 event schema (page_view, view_item, add_to_cart, etc.).✓ Copiado
    → Event list with parameters and sample payloads
  2. Sync to GTM
    Sync this schema into GTM container GTM-ABCDEF as tags + triggers + variables.✓ Copiado
    → Workspace changes reported
  3. Preview and verify
    Open Preview on staging.example.com and verify each event fires.✓ Copiado
    → Per-event fire/miss report
  4. Publish
    Publish version with notes 'initial GA4 setup'.✓ Copiado
    → Live version ID returned

Resultado: A GA4-tracked site with events flowing within an hour.

Armadilhas
  • 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
Combine com: 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

Quando usar: You have basic tracking but ecommerce funnels are empty.

Fluxo
  1. Infer product events
    Scan /shop and /checkout and propose the full GA4 ecommerce event list.✓ Copiado
    → 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.✓ Copiado
    → Per-event dataLayer.push snippet
  3. Wire in GTM
    Create the matching GA4 tags and triggers in GTM.✓ Copiado
    → Tags linked to dataLayer events

Resultado: Full ecommerce funnel visible in GA4.

Combine com: ecommerce-skill

Audit an existing GTM container for coverage gaps

👤 Analysts inheriting a messy GTM ⏱ ~30 min advanced

Quando usar: You're on a new team; GTM was set up years ago; nobody knows what's live.

Fluxo
  1. Dump container state
    Read GTM container GTM-XXXX and list every active tag, trigger, and variable.✓ Copiado
    → 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.✓ Copiado
    → Gap + cruft list

Resultado: A cleanup PR list for your GTM workspace.

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado
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.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
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

Custo e limites

O que custa rodar

Cota de API
GTM Tag Manager API: 250 req / 100s per user; generous for manual setup
Tokens por chamada
10-30k tokens per full setup
Monetário
Free (GA4 + GTM are free)
Dica
Scope scans to 5-10 key pages to avoid long crawls.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Service account JSON in env var or file path. GTM write scope: tagmanager.edit.containers, tagmanager.publish.
Saída de dados: Site scan reads your URLs; schema is pushed to Google Tag Manager.
Nunca conceda: tagmanager.delete.containers

Solução de problemas

Erros comuns e correções

401 Unauthorized on Tag Manager API

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

Verificar: 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.

Alternativas

event-tracking-skill vs. outros

AlternativaQuando usarTroca
Manual GTM setupYou need custom logic the LLM can't safely generateSlower, more error-prone

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills