Saltar al contenido

Estadísticas

Los endpoints de Statistics ofrecen analíticas detalladas sobre tus apps y organizaciones. Puedes hacer seguimiento de los usuarios activos mensuales (MAU), el uso de almacenamiento y el consumo de ancho de banda en distintos periodos. Estos datos son esenciales para monitorear el crecimiento de la app, el uso de recursos y planificar la capacidad.

  • MAU (usuarios activos mensuales): Número de dispositivos únicos que accedieron a tu app en los últimos 30 días
  • Almacenamiento: Tamaño total en bytes de todos los bundles y recursos almacenados
  • Ancho de banda: Transferencia total de datos de descargas de bundles, en bytes
  1. Monitoreo regular: Consulta las estadísticas periódicamente para seguir el crecimiento y los patrones de uso
  2. Planificación de recursos: Usa métricas de almacenamiento y ancho de banda para planificar la capacidad
  3. Engagement del usuario: Sigue el MAU para ver las tendencias de engagement de usuarios
  4. Gestión de costos: Monitorea el uso de recursos para optimizar costos

Obtén las estadísticas de una app específica. Este endpoint es útil para monitorear el rendimiento de cada app.

interface StatsQuery {
from: Date // Start date for the statistics (format: YYYY-MM-DD)
to: Date // End date for the statistics (format: YYYY-MM-DD)
}
Ventana de terminal
curl -H "authorization: your-api-key" \
"https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"
[
{
"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
}
]

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

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
}
Ventana de terminal
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"
[
{
"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
}
]

Obtén estadísticas agregadas de todas las organizaciones a las que tienes acceso. Ideal para el monitoreo general del uso.

interface StatsQuery {
from: Date // Start date for the statistics (format: YYYY-MM-DD)
to: Date // End date for the statistics (format: YYYY-MM-DD)
}
Ventana de terminal
curl -H "authorization: your-api-key" \
"https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"
[
{
"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
}
]

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

interface BundleUsageQuery {
from: Date // Start date for the statistics (format: YYYY-MM-DD)
to: Date // End date for the statistics (format: YYYY-MM-DD)
}
Ventana de terminal
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"
{
"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]
}
]
}

Todos los errores utilizan el formato estándar descrito en la visión general de API.

Escenarios de error comunes y sus respuestas:

// The API key cannot read this app (HTTP 401)
{
"error": "no_access_to_app",
"message": "No access to app",
"moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}
// The API key cannot read this organization (HTTP 401)
{
"error": "no_access_to_organization",
"message": "No access to organization",
"moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}
// Organization statistics require an active plan (HTTP 402)
{
"error": "subscription_required",
"message": "Organization subscription required or plan invalid",
"moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8", "isPayingAndGoodPlan": false }
}
// User statistics when the user belongs to no organization (HTTP 401)
{
"error": "no_organizations_found",
"message": "No organizations found",
"moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }
}
  1. Seguimiento de crecimiento: Supervisa el crecimiento de MAU con el tiempo
  2. Optimización de recursos: Controla el uso de almacenamiento y ancho de banda para optimizar costos
  3. Planificación de capacidad: Use trends to plan for future resource needs
  4. Informes de uso: Genera informes periódicos de uso para los interesados
  5. Análisis de distribución de bundles (versiones): Comprende cómo se distribuyen los usuarios entre los distintos bundles de la app (versiones) mediante estadísticas de uso de bundles
  1. Comparar periodos: Analiza tendencias mes a mes o año tras año
  2. Seguimiento de ratios: Monitorea el ancho de banda por usuario o el almacenamiento por app
  3. Configurar alertas: Crea alertas para detectar picos de uso inusuales
  4. Backups regulares: Exporta estadísticas periódicamente para el análisis histórico
  5. Adopción de bundles (versiones): Usa el uso de bundles para medir la adopción de nuevos bundles (versiones)

Si estás usando Estadísticas para planificar el almacenamiento y la gestión de archivos, conéctalo con @capgo/capacitor-data-storage-sqlite para el detalle de implementación en @capgo/capacitor-data-storage-sqlite, Uso de @capgo/capacitor-data-storage-sqlite para la funcionalidad nativa en Uso de @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file para el detalle de implementación en @capgo/capacitor-file, Uso de @capgo/capacitor-file para la funcionalidad nativa en Uso de @capgo/capacitor-file, y @capgo/capacitor-uploader para el detalle de implementación en @capgo/capacitor-uploader.

Estado de las releases, errores y builds nativos

Sección titulada “Salud de la release, errores y builds nativos”

Usa la monitoreo de API para diagnósticos nativos y del actualizador, logs con metadatos, estadísticas del dashboard de la release en vivo, y estado del build nativo y snapshots de logs. Estas lecturas también las exponen ambos servidores MCP de la cuenta.

Lee la adopción de la versión nativa y el número de dispositivos activos diarios para from y to fechas. La respuesta incluye labels, gráfico datasets, latestVersion, activeDevices, previousPeriodActiveDevices, y dailyPlatformActive.

dailyPlatformActive es un objeto que contiene labels como cadenas de fecha y android, ios, electron, unknown, y total como matrices de números alineadas con esas fechas. No es una matriz de filas. Las lecturas secundarias de dispositivos activos pueden degradarse a datos vacíos si no están disponibles; los valores vacíos no demuestran que no haya dispositivos activos.