● 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
- Análisis automatizado de sitios para inferir necesidades de seguimiento
- Generación de esquema de eventos conforme a GA4
- Sincronización de contenedor GTM mediante Tag Manager API
- Verificación de vista previa antes de publicar
- Publicación con un clic de la versión del contenedor de etiquetas
- Compatible con múltiples agentes
Demo en vivo
Cómo se ve en la práctica
event-tracking-skill.replay
▶ listo
Casos de uso
Usos del mundo real: event-tracking-skill
Cuándo usarlo: Tienes un sitio en vivo, sin seguimiento aún, y una fecha límite.
Flujo
-
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
-
Sincronizar con GTM
Sincroniza este esquema en el contenedor GTM GTM-ABCDEF como etiquetas + disparadores + variables.✓ Copiado
→ Cambios del espacio de trabajo reportados
-
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
-
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
Cuándo usarlo: Tienes seguimiento básico pero los embudos de ecommerce están vacíos.
Flujo
-
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[]
-
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
-
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.
Cuándo usarlo: Estás en un equipo nuevo; GTM se configuró hace años; nadie sabe qué está en vivo.
Flujo
-
Obtener estado del contenedor
Lee el contenedor GTM GTM-XXXX y lista cada etiqueta, disparador y variable activos.✓ Copiado
→ Inventario normalizado
-
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
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
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
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
- La cuenta de servicio tiene derechos de edición de contenedor. Limita a un contenedor único, no a toda la organización GCP.
- El paso de publicación está en vivo en el sitio. Siempre verifica en Preview primero.
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
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| Configuración manual de GTM | Necesitas lógica personalizada que el LLM no puede generar de forma segura | Más lento, más propenso a errores |