Estadísticas

Los puntos finales de estadísticas proporcionan análisis detallados sobre sus aplicaciones y organizaciones. Puede rastrear usuarios activos mensuales (MAU), uso de almacenamiento y consumo de ancho de banda en diferentes períodos de tiempo. Esta información es fundamental para monitorear el crecimiento de las aplicaciones, el uso de recursos y planificar la capacidad.

Entendiendo las Métricas

• MAU (Usuarios Activos Mensuales): Número de dispositivos únicos que accedieron a su aplicación en los últimos 30 días
• Almacenamiento: Tamaño total de todos los paquetes y recursos almacenados en bytes
• Ancho de Banda: Transferencia de datos total para descargas de paquetes en bytes

Prácticas recomendadas

1. Monitoreo regular: Verifique estadísticas periódicamente para rastrear el crecimiento y los patrones de uso
2. Planificación de recursos: Utilice métricas de almacenamiento y ancho de banda para la planificación de capacidad
3. Participación del usuario: Rastreé MAU para comprender las tendencias de participación del usuario
4. Gestión de costos: Monitoree el uso de recursos para optimizar costos

Puntos finales

GET /estadísticas/aplicación/:app_id/

Obtener estadísticas para una aplicación específica. Esta ruta es útil para monitorear el rendimiento de una aplicación individual.

Parámetros de consulta

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Solicitud de ejemplo

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"

Respuesta de ejemplo

[
  {
    "date": "2024-01-01",
    "mau": 1500,
    "storage": 536870912,  // 512MB in bytes
    "bandwidth": 1073741824 // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 1550,
    "storage": 537919488,  // 513MB in bytes
    "bandwidth": 1074790400 // 1.01GB in bytes
  }
]

GET /statistics/org/:org_id/

Obtener estadísticas para una organización específica. Útil para monitorear el uso a nivel de organización.

Parámetros de consulta

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
  breakdown: boolean  // default false, optional if true it return the breakdown by app
  noAccumulate: boolean // default false, optional if true it will not accumulate data and just return day by day result
}

Solicitud de ejemplo

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/org/046a36ac-e03c-4590-9257-bd6c9dba9ee8/?from=2024-01-01&to=2024-02-01"

Respuesta de ejemplo

[
  {
    "date": "2024-01-01",
    "mau": 10000,
    "storage": 536870912,   // 512MB in bytes
    "bandwidth": 1073741824  // 1GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 10200,
    "storage": 537919488,   // 513MB in bytes
    "bandwidth": 1074790400  // 1.01GB in bytes
  }
]

GET /statistics/user/

Obtenga estadísticas agregadas a través de todas las organizaciones a las que tiene acceso. Ideal para el seguimiento de uso general.

Parámetros de consulta

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Solicitud de ejemplo

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"

Respuesta de ejemplo

[
  {
    "date": "2024-01-01",
    "mau": 25000,
    "storage": 1073741824,  // 1GB in bytes
    "bandwidth": 2147483648  // 2GB in bytes
  },
  {
    "date": "2024-01-02",
    "mau": 25500,
    "storage": 1074790400,  // 1.01GB in bytes
    "bandwidth": 2148532224  // 2.01GB in bytes
  }
]

GET /estadísticas de la aplicación / : app_id / uso de paquetes

Obtener estadísticas de uso de paquetes para una aplicación específica, mostrando la distribución de paquetes (versiones) entre los usuarios durante un período determinado.

Parámetros de consulta

interface BundleUsageQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Solicitud de ejemplo

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/bundle_usage?from=2024-01-01&to=2024-02-01"

Respuesta de ejemplo

{
  "labels": ["2024-01-01", "2024-01-02", "2024-01-03"],
  "datasets": [
    {
      "label": "1.0.0",
      "data": [60.5, 58.2, 55.3]
    },
    {
      "label": "1.0.1",
      "data": [39.5, 41.8, 44.7]
    }
  ]
}

Gestión de errores

Escenarios de errores comunes y sus respuestas:

// Invalid body
{
  "status": "Invalid body",
  "error": "Invalid date format or missing parameters"
}

// Permission denied
{
  "status": "You can't access this app",
  "error": "Insufficient permissions to access statistics"
}

// Permission denied for organization
{
  "status": "You can't access this organization",
  "error": "Insufficient permissions to access organization statistics"
}

// No organizations found for user statistics
{
  "status": "No organizations found",
  "error": "No organizations found"
}

// Internal server error
{
  "status": "Cannot get app statistics",
  "error": "Internal server error message"
}

Uso común

1. Seguimiento del crecimientoMonitorear el crecimiento mensual activo de usuarios a lo largo del tiempo
2. Optimización de Recursos: Rastrear el uso de almacenamiento y ancho de banda para optimizar costos
3. Planificación de Capacidad: Utilizar tendencias para planificar las necesidades de recursos futuras
4. Informes de Uso: Generar informes de uso periódicos para los interesados
5. Análisis de Distribución de Paquetes (versión): Comprender cómo los usuarios están distribuidos en diferentes paquetes de la aplicación (versiones) con estadísticas de uso de paquetes

Consejos para el Análisis

1. Comparar Períodos: Mirar las tendencias de mes a mes o año a año
2. Seguir Rátios: Monitorear ancho de banda por usuario o almacenamiento por aplicación
3. Establecer Alertas: Crear alertas para picos inusuales en el uso
4. Respaldo Regular: Exportar estadísticas regularmente para análisis histórico
5. Empaquetar (versión) Adopción: Utilizar el uso de paquetes para seguir las tasas de adopción de nuevos paquetes (versiones)