/ Directorio / Playground / event-tracking-skill
● Comunidad jtrackingai ⚡ Instantáneo

event-tracking-skill

por jtrackingai · jtrackingai/event-tracking-skill

Seguimiento de eventos GA4 + GTM automatizado — análisis de sitio, esquema de eventos, sincronización GTM, verificación de vista previa y publicación desde tu agente.

La Skill Event Tracking automatiza el flujo completo de seguimiento de eventos GA4: escanear un sitio, proponer un esquema de eventos alineado con las convenciones de GA4, sincronizar con Google Tag Manager, verificar en GTM Preview y publicar. Funciona en Claude Code, Cursor y Codex. Elimina la parte repetitiva del trabajo analítico.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

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

Instalar

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la 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
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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
    }
  }
}

Mismo formato que Claude Desktop. Reinicia 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"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.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"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: event-tracking-skill

Cómo configurar GA4 + GTM desde cero en un nuevo sitio

👤 Especialistas en marketing y desarrolladores full-stack que instrumentan un nuevo sitio ⏱ ~60 min intermediate

Cuándo usarlo: Tienes un sitio en vivo, sin seguimiento aún, y una fecha límite.

Requisitos previos
  • Skill instalada — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • Propiedad de GA4 + contenedor de GTM — Crea en Google Tag Manager; anota el ID GTM-XXXXXX
  • Cuenta de servicio con acceso a la API de Tag Manager — Consola de GCP → habilita la API de Tag Manager → JSON de cuenta de servicio
Flujo
  1. Escanear el sitio
    Escanea https://example.com y propón un esquema de eventos GA4 (page_view, view_item, add_to_cart, etc.).✓ Copiado
    → Lista de eventos con parámetros y cargas útiles de muestra
  2. Sincronizar con GTM
    Sincroniza este esquema en el contenedor GTM GTM-ABCDEF como etiquetas + disparadores + variables.✓ Copiado
    → Cambios del espacio de trabajo reportados
  3. Vista previa y verificación
    Abre la Vista previa en staging.example.com y verifica que cada evento se active.✓ Copiado
    → Informe de activación/fallo por evento
  4. Publicar
    Publica la versión con notas 'configuración inicial de GA4'.✓ Copiado
    → ID de versión en vivo devuelto

Resultado: Un sitio rastreado con GA4 con eventos fluyendo en menos de una hora.

Errores comunes
  • Los eventos se activan pero no aparecen en GA4 durante 24 horas — Usa DebugView en GA4 para verificación en tiempo real durante las pruebas
  • Conflictos del espacio de trabajo de GTM con ediciones manuales — Crea un espacio de trabajo dedicado para los cambios de la Skill para evitar afectar el trabajo de otros
Combinar con: seo-audit-skill

Agregar eventos de ecommerce GA4 a un sitio existente

👤 Operadores de ecommerce ya en GA4 pero sin seguimiento de compra/visualización de artículos ⏱ ~45 min intermediate

Cuándo usarlo: Tienes seguimiento básico pero los embudos de ecommerce están vacíos.

Flujo
  1. Inferir eventos de producto
    Escanea /shop y /checkout y propón la lista completa de eventos de ecommerce de GA4.✓ Copiado
    → view_item_list, view_item, add_to_cart, begin_checkout, purchase con parámetro items[]
  2. Configurar patrones de push de dataLayer
    Genera fragmentos de JS para hacer push de cada evento desde nuestros componentes de React.✓ Copiado
    → Fragmento de dataLayer.push por evento
  3. Conectar en GTM
    Crea las etiquetas y disparadores de GA4 coincidentes en GTM.✓ Copiado
    → Etiquetas vinculadas a eventos de dataLayer

Resultado: Embudo de ecommerce completo visible en GA4.

Combinar con: ecommerce-skill

Auditar un contenedor GTM existente para identificar brechas de cobertura

👤 Analistas que heredan un GTM desordenado ⏱ ~30 min advanced

Cuándo usarlo: Estás en un equipo nuevo; GTM se configuró hace años; nadie sabe qué está en vivo.

Flujo
  1. Obtener estado del contenedor
    Lee el contenedor GTM GTM-XXXX y lista cada etiqueta, disparador y variable activos.✓ Copiado
    → Inventario normalizado
  2. Comparar con el sitio
    Ahora escanea el sitio y muestra qué eventos se activan en GTM Preview pero ya no son significativos, y cuáles deberían existir pero no.✓ Copiado
    → Lista de brechas y elementos obsoletos

Resultado: Una lista de PR de limpieza para tu espacio de trabajo de GTM.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

event-tracking-skill + seo-audit-skill

La auditoría SEO identifica problemas estructurales, event-tracking configura la medición

Ejecuta seo-audit, corrige las brechas estructurales, luego event-tracking-skill para configuración de GA4.✓ Copiado
event-tracking-skill + ecommerce-skill

La Skill de ecommerce configura embudos, event-tracking los instrumenta

Usa ecommerce-skill para rediseñar el checkout, luego event-tracking para conectar eventos de compra.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
scan_site url Antes de cualquier cambio en GTM tokens de Claude
sync_gtm container_id, schema Después de revisar el esquema 1+ llamadas a la API de Tag Manager
preview_verify container_id, target_url Antes de publicar 0
publish_version container_id, notes Después de que la vista previa sea aprobada 1 llamada a API
audit_container container_id Heredar un GTM existente 1+ llamadas a API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
GTM Tag Manager API: 250 req / 100s por usuario; generoso para configuración manual
Tokens por llamada
10-30k tokens por configuración completa
Monetario
Gratis (GA4 + GTM son gratuitos)
Consejo
Limita los escaneos a 5-10 páginas clave para evitar rastreos largos.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: JSON de cuenta de servicio en variable de entorno o ruta de archivo. Alcance de escritura de GTM: tagmanager.edit.containers, tagmanager.publish.
Salida de datos: El escaneo del sitio lee tus URLs; el esquema se envía a Google Tag Manager.
No conceder nunca: tagmanager.delete.containers

Resolución de problemas

Errores comunes y soluciones

401 Unauthorized en la API de Tag Manager

La cuenta de servicio no se agregó como usuario en el contenedor de GTM. Agrega en Administrador de GTM → Gestión de usuarios.

Verificar: curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
La Vista previa muestra eventos que se activan pero DebugView de GA4 está vacío

Falta la etiqueta de configuración de GA4 o se envía a una identificación de medición incorrecta. Verifica G-XXXXXX en la etiqueta de configuración.

La versión publicada revierte cambios

Otro espacio de trabajo se publicó después del tuyo. Reconcilia ambos espacios de trabajo, fusiona, republica.

Alternativas

event-tracking-skill vs otros

AlternativaCuándo usarlaContrapartida
Configuración manual de GTMNecesitas lógica personalizada que el LLM no puede generar de forma seguraMás lento, más propenso a errores

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills