/ Annuaire / Playground / event-tracking-skill
● Communauté jtrackingai ⚡ Instantané

event-tracking-skill

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

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

event-tracking-skill.replay ▶ prêt
0/0

Installer

Choisissez votre client

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.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 utilise un tableau d'objets serveur plutôt qu'une 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"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : 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

Quand l'utiliser : You have a site live, no tracking yet, and a deadline.

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

Résultat : A GA4-tracked site with events flowing within an hour.

Pièges
  • 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
Combiner avec : 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

Quand l'utiliser : You have basic tracking but ecommerce funnels are empty.

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

Résultat : Full ecommerce funnel visible in GA4.

Combiner avec : ecommerce-skill

Audit an existing GTM container for coverage gaps

👤 Analysts inheriting a messy GTM ⏱ ~30 min advanced

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

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

Résultat : A cleanup PR list for your GTM workspace.

Combinaisons

Associez-le à d'autres MCPs pour un effet 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.✓ Copié
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.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
GTM Tag Manager API: 250 req / 100s per user; generous for manual setup
Tokens par appel
10-30k tokens per full setup
Monétaire
Free (GA4 + GTM are free)
Astuce
Scope scans to 5-10 key pages to avoid long crawls.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Service account JSON in env var or file path. GTM write scope: tagmanager.edit.containers, tagmanager.publish.
Sortie de données : Site scan reads your URLs; schema is pushed to Google Tag Manager.
Ne jamais accorder : tagmanager.delete.containers

Dépannage

Erreurs courantes et correctifs

401 Unauthorized on Tag Manager API

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

Vérifier : 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.

Alternatives

event-tracking-skill vs autres

AlternativeQuand l'utiliserCompromis
Manual GTM setupYou need custom logic the LLM can't safely generateSlower, more error-prone

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills