Statistiques
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Les endpoints Statistics fournissent des analyses détaillées sur vos applications et organisations. Vous pouvez suivre les utilisateurs actifs mensuels (MAU), l’utilisation du stockage et la consommation de bande passante sur différentes périodes. Ces données sont essentielles pour surveiller la croissance de l’application, l’utilisation des ressources et planifier la capacité.
Comprendre les métriques
Section intitulée « Comprendre les métriques »- MAU (utilisateurs actifs mensuels): Nombre d’appareils uniques ayant accédé à votre application au cours des 30 derniers jours
- Stockage: Taille totale de tous les bundles et ressources stockés, en octets
- Bande passante: Total data transfer for bundle downloads in bytes
Bonnes pratiques
Section intitulée « Bonnes pratiques »- Surveillance régulière: Consultez les statistiques périodiquement pour suivre la croissance et les modèles d’utilisation
- Planification des ressources: Utilisez les métriques de stockage et de bande passante pour le dimensionnement
- Engagement utilisateur: Track MAU to understand user engagement trends
- Gestion des coûts: Monitor resource usage to optimize costs
Endpoints
Section intitulée « Endpoints »GET /statistics/app/:app_id/
Section intitulée « GET /statistics/app/:app_id/ »Récupérer les statistiques d'une application donnée. Cet endpoint est utile pour surveiller les performances d'une application en particulier.
Paramètres de requête
Section intitulée « Paramètres de requête »interface StatsQuery { from: Date // Start date for the statistics (format: YYYY-MM-DD) to: Date // End date for the statistics (format: YYYY-MM-DD)}Exemple de requête
Section intitulée « Exemple de requête »curl -H "authorization: your-api-key" \ "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"Exemple de réponse
Section intitulée « Exemple de réponse »[ { "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/
Section intitulée « GET /statistics/org/:org_id/ »Récupère les statistiques d’une organisation spécifique. Utile pour surveiller l’utilisation au niveau de l’organisation.
Paramètres de requête
Section intitulée « Paramètres de requête »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}Exemple de requête
Section intitulée « Exemple de requête »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"Exemple de réponse
Section intitulée « Exemple de réponse »[ { "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/
Section intitulée « GET /statistics/user/ »Récupérez des statistiques agrégées sur toutes les organisations auxquelles vous avez accès. Idéal pour surveiller l’utilisation globale.
Paramètres de requête
Section intitulée « Paramètres de requête »interface StatsQuery { from: Date // Start date for the statistics (format: YYYY-MM-DD) to: Date // End date for the statistics (format: YYYY-MM-DD)}Exemple de requête
Section intitulée « Exemple de requête »curl -H "authorization: your-api-key" \ "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"Exemple de réponse
Section intitulée « Exemple de réponse »[ { "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
Section intitulée « GET /statistics/app/:app_id/bundle_usage »Récupère les statistiques d’utilisation des bundles d’une application spécifique, en affichant la répartition des bundles (versions) parmi les utilisateurs sur une période donnée.
Paramètres de requête
Section intitulée « Paramètres de requête »interface BundleUsageQuery { from: Date // Start date for the statistics (format: YYYY-MM-DD) to: Date // End date for the statistics (format: YYYY-MM-DD)}Exemple de requête
Section intitulée « Exemple de requête »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"Exemple de réponse
Section intitulée « Exemple de réponse »{ "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] } ]}Gestion des erreurs
Section intitulée « Gestion des erreurs »Toutes les erreurs utilisent le format d'erreur standard décrit dans la Aperçu de API.
Scénarios d'erreur courants et leurs réponses :
// 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" }}Cas d'usage courants
Section intitulée « Cas d'utilisation courants »- Suivi de la croissance: Suivre la croissance des MAU dans le temps
- Optimisation des ressources: Track storage and bandwidth usage to optimize costs
- Planification de la capacité: Utilisez les tendances pour anticiper vos besoins en ressources
- Rapports d'utilisation: Générez des rapports d'utilisation périodiques pour les parties prenantes
- Analyse de la répartition des bundles (versions): Comprendre la répartition des utilisateurs entre les différents bundles (versions) de l’application grâce aux statistiques d’utilisation des bundles
Conseils d'analyse
Section intitulée « Conseils pour l'analyse »- Comparer les périodes: Analysez les tendances mensuelles ou annuelles
- Suivre les ratios: Surveillez la bande passante par utilisateur ou le stockage par app
- Set Alerts: Créez des alertes pour les pics d'utilisation inhabituels
- Sauvegardes régulières: Exportez régulièrement les statistiques pour une analyse historique
- Adoption des bundles (versions): Utilisez l'usage des bundles pour suivre le taux d'adoption des nouveaux bundles (versions)
Continuer à partir des statistiques
Section intitulée « Continuer à partir des statistiques »Si vous utilisez Statistiques pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utiliser @capgo/capacitor-data-storage-sqlite pour la capacité native dans Utiliser @capgo/capacitor-data-storage-sqlite @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file, Utiliser @capgo/capacitor-file pour la capacité native dans Utiliser @capgo/capacitor-file, et @capgo/capacitor-uploader pour les détails d'implémentation dans @capgo/capacitor-uploader.
Santé des releases, erreurs et builds natifs
Section intitulée « Santé des releases, erreurs et builds natifs »Utilisez le surveillance de API pour les diagnostics natifs et de l’updater, les logs avec métadonnées, les statistiques du dashboard de la release live, ainsi que l’état et les instantanés de logs des builds natifs. Ces lectures sont également exposées par les deux serveurs MCP du compte.
GET /statistics/app/:app_id/native_usage
Section intitulée « GET /statistics/app/:app_id/native_usage »Lire l’adoption des versions natives et le nombre d’appareils actifs quotidiens pour from et to dates. La réponse inclut labels, chart datasets, latestVersion, activeDevices, previousPeriodActiveDevices, et dailyPlatformActive.
dailyPlatformActive est un objet contenant labels en tant que chaînes de dates et android, ios, electron, unknown, et total en tant que tableaux de nombres alignés sur ces dates. Ce n’est pas un tableau de lignes. Les lectures secondaires d’appareils actifs peuvent se dégrader en données vides si indisponibles ; des valeurs vides ne prouvent pas qu’aucun appareil n’est actif.