Estadísticas

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

Entendiendo los Métricas

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

Prácticas recomendadas

1. Monitoreo regularVerifique 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 planificar la capacidad
3. Participación del usuario: Siga el MAU para comprender las tendencias de compromiso del usuario
4. Gestión de costos: Monitoree el uso de recursos para optimizar los costos

Puntos finales

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

Obtenga estadísticas para una aplicación específica. Este punto final es útil para monitorear el rendimiento individual de una aplicació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)
}

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 /estadísticas/organización/: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
  }
]

OBTENER /estadísticas/usuario/

OBTÉN estadísticas agrupadas de todas las organizaciones a las que tienes acceso. Ideal para el monitoreo 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 /statistics/app/: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"
}

Casos de uso comunes

1. Seguimiento del crecimiento: Monitoree el crecimiento del MAU con el tiempo
2. Optimización de Recursos: Siga el uso de almacenamiento y ancho de banda para optimizar costos
3. Planificación de Capacidad: Utilice las tendencias para planificar recursos futuros
4. Informes de Uso: Genere informes periódicos de uso para partes interesadas
5. Análisis de Distribución de Conjuntos (versión): Entienda cómo los usuarios están distribuidos en diferentes conjuntos de aplicaciones (versiones) con estadísticas de uso de conjuntos

Consejos para el Análisis

1. Comparar PeríodosMira las tendencias de mes a mes o año a año
2. Seguir Rátios: Monitorea la banda por usuario o almacenamiento por aplicación
3. Establecer Alertas: Crea alertas para picos anormales en el uso
4. Copias de Seguridad Regulares: Exporta estadísticas regularmente para análisis histórico
5. Adopción de Conjunto (versión)Utilice el uso de paquetes para rastrear las tasas de adopción de nuevos paquetes (versiones).

Sigue adelante desde Estadísticas

Si estás utilizando Estadísticas para planificar el almacenamiento y el manejo de archivos, conecte con @capgo/capacitor-almacenamiento-de-datos-sqlite para el detalle de implementación en @capgo/capacitor-almacenamiento-de-datos-sqlite, Usando @capgo/capacitor-almacenamiento-de-datos-sqlite para la capacidad nativa en Usando @capgo/capacitor-almacenamiento-de-datos-sqlite, @capgo/capacitor-archivo para el detalle de implementación en @capgo/capacitor-archivo, Usando @capgo/capacitor-archivo para la capacidad nativa en Usando @capgo/capacitor-archivo, y @capgo/capacitor-subidor para el detalle de implementación en @capgo/capacitor-subidor.