Ejemplos de Uso / Usage Examples

December 5, 2025 · View on GitHub

Esta guía contiene ejemplos prácticos de cómo usar el servidor MCP de Google Analytics con Claude.

📊 Lectura de Datos (Data API)

Ejemplo 1: Usuarios activos por país (última semana)

Pregunta a Claude:

Muéstrame los 10 países con más usuarios activos en la última semana

Lo que Claude hará: Claude utilizará la herramienta ga_run_report con estos parámetros:

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "country"}],
  "metrics": [{"name": "activeUsers"}],
  "limit": 10,
  "orderBys": [{"metric": {"metricName": "activeUsers"}, "desc": true}]
}

Resultado esperado:

País                Usuarios Activos
Estados Unidos      15,234
México              8,721
España              6,543
Argentina           4,231
Colombia            3,876
...

Ejemplo 2: Páginas más vistas (mes actual)

Pregunta a Claude:

¿Cuáles son las 5 páginas más visitadas este mes?

Parámetros que Claude usará:

{
  "dateRanges": [{"startDate": "2024-01-01", "endDate": "today"}],
  "dimensions": [{"name": "pagePath"}],
  "metrics": [{"name": "screenPageViews"}],
  "limit": 5,
  "orderBys": [{"metric": {"metricName": "screenPageViews"}, "desc": true}]
}

Ejemplo 3: Tráfico por dispositivo (tiempo real)

Pregunta a Claude:

Muéstrame cuántos usuarios hay ahora mismo por tipo de dispositivo

Herramienta: ga_run_realtime_report

{
  "dimensions": [{"name": "deviceCategory"}],
  "metrics": [{"name": "activeUsers"}],
  "limit": 10
}

Resultado:

Dispositivo    Usuarios Activos
mobile         127
desktop        89
tablet         12

Ejemplo 4: Conversiones por fuente de tráfico

Pregunta a Claude:

Muéstrame las conversiones de la última semana agrupadas por fuente de tráfico

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
  "dimensions": [{"name": "sessionSource"}],
  "metrics": [
    {"name": "sessions"},
    {"name": "conversions"}
  ],
  "limit": 15,
  "orderBys": [{"metric": {"metricName": "conversions"}, "desc": true}]
}

Ejemplo 5: Análisis de embudo de conversión

Pregunta a Claude:

Analiza mi embudo de conversión: vista de producto → añadir al carrito → iniciar pago → compra

Herramienta: ga_run_funnel_report

{
  "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
  "funnelSteps": [
    {"name": "view_item"},
    {"name": "add_to_cart"},
    {"name": "begin_checkout"},
    {"name": "purchase"}
  ]
}

Ejemplo 6: Obtener dimensiones y métricas disponibles

Pregunta a Claude:

¿Qué dimensiones y métricas están disponibles en mi propiedad de GA4?

Herramienta: ga_get_metadata

⚠️ Advertencia: Este comando devuelve más de 500 items. Úsalo con moderación.

Ejemplo 7: Reporte de tabla dinámica

Pregunta a Claude:

Crea una tabla dinámica mostrando usuarios activos por país y tipo de dispositivo

Herramienta: ga_run_pivot_report

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
  "dimensions": [
    {"name": "country"},
    {"name": "deviceCategory"}
  ],
  "metrics": [{"name": "activeUsers"}],
  "pivots": [
    {"fieldNames": ["deviceCategory"], "limit": 3}
  ]
}

📤 Envío de Eventos (Measurement Protocol)

Ejemplo 8: Enviar evento personalizado

Pregunta a Claude:

Envía un evento personalizado llamado "newsletter_signup" con el parámetro source="homepage"

Herramienta: ga_send_event

{
  "events": [{
    "name": "newsletter_signup",
    "params": {
      "source": "homepage",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  }],
  "user_id": "user_12345"
}

Ejemplo 9: Enviar vista de página

Pregunta a Claude:

Registra una vista de página para https://ejemplo.com/productos

Herramienta: ga_send_pageview

{
  "page_location": "https://ejemplo.com/productos",
  "page_title": "Productos - Mi Tienda",
  "page_referrer": "https://google.com",
  "user_id": "user_12345"
}

Ejemplo 10: Registrar una compra

Pregunta a Claude:

Registra una compra: orden #ORD-12345, total \$249.99 USD, 2 productos

Herramienta: ga_send_purchase

{
  "transaction_id": "ORD-12345",
  "value": 249.99,
  "currency": "USD",
  "tax": 20.00,
  "shipping": 10.00,
  "items": [
    {
      "item_id": "SKU-001",
      "item_name": "Camiseta Premium",
      "price": 99.99,
      "quantity": 1,
      "item_brand": "MiMarca",
      "item_category": "Ropa"
    },
    {
      "item_id": "SKU-002",
      "item_name": "Pantalón Deportivo",
      "price": 149.99,
      "quantity": 1,
      "item_brand": "MiMarca",
      "item_category": "Ropa"
    }
  ],
  "user_id": "user_12345"
}

Ejemplo 11: Validar evento antes de enviar

Pregunta a Claude:

Valida este evento antes de enviarlo: tipo "purchase", valor 500 USD

Herramienta: ga_validate_event

{
  "events": [{
    "name": "purchase",
    "params": {
      "transaction_id": "TEST-001",
      "value": 500,
      "currency": "USD",
      "items": [{
        "item_id": "PROD-123",
        "item_name": "Producto Test",
        "price": 500,
        "quantity": 1
      }]
    }
  }],
  "user_id": "user_test"
}

Resultado: Claude mostrará si hay errores o warnings en el evento antes de enviarlo a producción.

Ejemplo 12: Registrar inicio de sesión

Pregunta a Claude:

Registra un inicio de sesión con Google para el usuario user_789

Herramienta: ga_send_login

{
  "user_id": "user_789",
  "method": "Google",
  "user_properties": {
    "account_type": {"value": "premium"},
    "signup_date": {"value": "2024-01-01"}
  }
}

Ejemplo 13: Agregar al carrito

Pregunta a Claude:

Registra que el usuario agregó un producto al carrito: ID "PROD-456", precio \$79.99

Herramienta: ga_send_add_to_cart

{
  "currency": "USD",
  "value": 79.99,
  "items": [{
    "item_id": "PROD-456",
    "item_name": "Zapatillas Running",
    "price": 79.99,
    "quantity": 1,
    "item_brand": "Nike",
    "item_category": "Calzado"
  }],
  "user_id": "user_456"
}

🎯 Casos de Uso Avanzados

Ejemplo 14: Análisis de rendimiento semanal completo

Pregunta a Claude:

Dame un análisis completo de la última semana: usuarios, sesiones, páginas vistas, tasa de conversión, y los 5 países principales

Claude puede usar múltiples herramientas o ga_batch_run_reports:

{
  "requests": [
    {
      "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
      "metrics": [
        {"name": "activeUsers"},
        {"name": "sessions"},
        {"name": "screenPageViews"},
        {"name": "conversions"}
      ]
    },
    {
      "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
      "dimensions": [{"name": "country"}],
      "metrics": [{"name": "activeUsers"}],
      "limit": 5,
      "orderBys": [{"metric": {"metricName": "activeUsers"}, "desc": true}]
    }
  ]
}

Ejemplo 15: Seguimiento de campaña de marketing

Pregunta a Claude:

Muéstrame el rendimiento de mis campañas de marketing de la última semana: sesiones, conversiones y tasa de conversión

{
  "dateRanges": [{"startDate": "7daysAgo", "endDate": "today"}],
  "dimensions": [
    {"name": "sessionCampaignName"}
  ],
  "metrics": [
    {"name": "sessions"},
    {"name": "conversions"}
  ],
  "dimensionFilter": {
    "filter": {
      "fieldName": "sessionCampaignName",
      "stringFilter": {
        "matchType": "EXACT",
        "value": "(not set)",
        "notExpression": true
      }
    }
  },
  "limit": 20,
  "orderBys": [{"metric": {"metricName": "conversions"}, "desc": true}]
}

Ejemplo 16: Comparar dos períodos

Pregunta a Claude:

Compara los usuarios activos de esta semana con la semana pasada

{
  "dateRanges": [
    {"startDate": "7daysAgo", "endDate": "today", "name": "Esta semana"},
    {"startDate": "14daysAgo", "endDate": "8daysAgo", "name": "Semana pasada"}
  ],
  "metrics": [{"name": "activeUsers"}]
}

💡 Tips para Optimización

✅ Buenas Prácticas

Usa límites siempre:

"limit": 10  // Empieza pequeño, aumenta si necesitas

Fechas específicas:

"7daysAgo", "yesterday", "today"  // Más eficiente que rangos largos

Ordena por métricas clave:

"orderBys": [{"metric": {"metricName": "conversions"}, "desc": true}]

Filtra datos irrelevantes:

"metricFilter": {
  "filter": {
    "fieldName": "sessions",
    "numericFilter": {
      "operation": "GREATER_THAN",
      "value": {"int64Value": "10"}
    }
  }
}

❌ Evitar

No pedir "todos los datos" sin límites
No usar múltiples dimensiones sin necesidad
No consultar rangos de fechas muy amplios (>90 días) sin filtros
No llamar ga_get_metadata repetidamente

🔍 Dimensiones y Métricas Comunes

Dimensiones Populares

date - Fecha
country - País
city - Ciudad
deviceCategory - Tipo de dispositivo
browser - Navegador
pagePath - Ruta de página
eventName - Nombre del evento
sessionSource - Fuente de sesión
sessionMedium - Medio de sesión
sessionCampaignName - Nombre de campaña

Métricas Populares

activeUsers - Usuarios activos
sessions - Sesiones
screenPageViews - Vistas de página
conversions - Conversiones
totalRevenue - Ingresos totales
engagementRate - Tasa de engagement
averageSessionDuration - Duración promedio de sesión
bounceRate - Tasa de rebote

📞 Soporte

Si tienes preguntas:

¡Feliz análisis! 📊