Aller au contenu

Statistiques

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é.

  • 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
  1. Surveillance régulière: Consultez les statistiques périodiquement pour suivre la croissance et les modèles d’utilisation
  2. Planification des ressources: Utilisez les métriques de stockage et de bande passante pour le dimensionnement
  3. Engagement utilisateur: Track MAU to understand user engagement trends
  4. Gestion des coûts: Monitor resource usage to optimize costs

Récupérer les statistiques d'une application donnée. Cet endpoint est utile pour surveiller les performances d'une application en particulier.

interface StatsQuery {
from: Date // Start date for the statistics (format: YYYY-MM-DD)
to: Date // End date for the statistics (format: YYYY-MM-DD)
}
Fenêtre 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
}
]

Récupère les statistiques d’une organisation spécifique. Utile pour surveiller l’utilisation au niveau de l’organisation.

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
}
Fenêtre 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
}
]

Récupérez des statistiques agrégées sur toutes les organisations auxquelles vous avez accès. Idéal pour surveiller l’utilisation globale.

interface StatsQuery {
from: Date // Start date for the statistics (format: YYYY-MM-DD)
to: Date // End date for the statistics (format: YYYY-MM-DD)
}
Fenêtre 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
}
]

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.

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

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" }
}
  1. Suivi de la croissance: Suivre la croissance des MAU dans le temps
  2. Optimisation des ressources: Track storage and bandwidth usage to optimize costs
  3. Planification de la capacité: Utilisez les tendances pour anticiper vos besoins en ressources
  4. Rapports d'utilisation: Générez des rapports d'utilisation périodiques pour les parties prenantes
  5. 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
  1. Comparer les périodes: Analysez les tendances mensuelles ou annuelles
  2. Suivre les ratios: Surveillez la bande passante par utilisateur ou le stockage par app
  3. Set Alerts: Créez des alertes pour les pics d'utilisation inhabituels
  4. Sauvegardes régulières: Exportez régulièrement les statistiques pour une analyse historique
  5. Adoption des bundles (versions): Utilisez l'usage des bundles pour suivre le taux d'adoption des nouveaux bundles (versions)

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.

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.

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.