Estadísticas
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
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.
Entender las métricas
Sección titulada “Entender las métricas”- 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
Buenas prácticas
Sección titulada “Buenas prácticas”- Monitoreo regular: Consulta las estadísticas periódicamente para seguir el crecimiento y los patrones de uso
- Planificación de recursos: Usa métricas de almacenamiento y ancho de banda para planificar la capacidad
- Engagement del usuario: Sigue el MAU para ver las tendencias de engagement de usuarios
- Gestión de costos: Monitorea el uso de recursos para optimizar costos
Endpoints
Sección titulada “Endpoints”GET /statistics/app/:app_id/
Sección titulada “GET /statistics/app/:app_id/”Obtén las estadísticas de una app específica. Este endpoint es útil para monitorear el rendimiento de cada app.
Parámetros de consulta
Sección titulada “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)}Ejemplo de solicitud
Sección titulada “Ejemplo de solicitud”curl -H "authorization: your-api-key" \ "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"Ejemplo de respuesta
Sección titulada “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/
Sección titulada “GET /statistics/org/:org_id/”Obtén estadísticas de una organización específica. Útil para monitorear el uso a nivel de organización.
Parámetros de consulta
Sección titulada “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}Ejemplo de solicitud
Sección titulada “Ejemplo de solicitud”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"Ejemplo de respuesta
Sección titulada “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/
Sección titulada “GET /statistics/user/”Obtén estadísticas agregadas de todas las organizaciones a las que tienes acceso. Ideal para el monitoreo general del uso.
Parámetros de consulta
Sección titulada “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)}Ejemplo de solicitud
Sección titulada “Ejemplo de solicitud”curl -H "authorization: your-api-key" \ "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"Ejemplo de respuesta
Sección titulada “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/bundle_usage
Sección titulada “GET /statistics/app/:app_id/bundle_usage”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.
Parámetros de consulta
Sección titulada “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)}Ejemplo de solicitud
Sección titulada “Ejemplo de solicitud”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"Ejemplo de respuesta
Sección titulada “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] } ]}Manejo de errores
Sección titulada “Manejo de errores”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" }}Casos de uso comunes
Sección titulada “Casos de uso comunes”- Seguimiento de crecimiento: Supervisa el crecimiento de MAU con el tiempo
- Optimización de recursos: Controla el uso de almacenamiento y ancho de banda para optimizar costos
- Planificación de capacidad: Use trends to plan for future resource needs
- Informes de uso: Genera informes periódicos de uso para los interesados
- 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
Consejos de análisis
Sección titulada «Consejos para el análisis»- Comparar periodos: Analiza tendencias mes a mes o año tras año
- Seguimiento de ratios: Monitorea el ancho de banda por usuario o el almacenamiento por app
- Configurar alertas: Crea alertas para detectar picos de uso inusuales
- Backups regulares: Exporta estadísticas periódicamente para el análisis histórico
- Adopción de bundles (versiones): Usa el uso de bundles para medir la adopción de nuevos bundles (versiones)
Continuar desde Statistics
Sección titulada “Continuar desde Statistics”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.
GET /statistics/app/:app_id/native_usage
Sección titulada “GET /statistics/app/:app_id/native_usage”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.