Statistiques

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

Les points de terminaison de Statistiques fournissent des informations détaillées sur les applications et les organisations. Vous pouvez suivre les Utilisateurs Actifs Mensuels (UAM), l'utilisation de stockage et la consommation de bande passante sur différents périodes de temps. Cette donnée est essentielle pour surveiller la croissance des applications, l'utilisation des ressources et la planification de la capacité.

Comprendre les Métriques

UAM (Utilisateurs Actifs Mensuels) :Nombre de dispositifs uniques qui ont 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 :Transfert de données total pour les téléchargements de bundles en octets

Meilleures Pratiques

Surveillance régulière: Vérifiez 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 la planification de capacité
Implication des utilisateurs: Suivez le nombre moyen d'utilisateurs actifs pour comprendre les tendances d'implication des utilisateurs
Gestion des coûts: Surveillez l'utilisation des ressources pour optimiser les coûts

Points de terminaison

GET /statistiques/app/:app_id/

Obtenez des statistiques pour une application spécifique. Cette fin de pointe est utile pour surveiller les performances individuelles d'une application.

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

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/app/com.demo.app/?from=2024-01-01&to=2024-02-01"

Réponse d'exemple

[
  {
    "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 /statistiques/org/:org_id/

Obtenez des statistiques pour une organisation spécifique. Utile pour surveiller l'utilisation au niveau de l'organisation.

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

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"

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 /statistiques/utilisateur/

Obtenez des statistiques agrégées sur tous les organismes auxquels vous avez accès. Parfait pour le suivi de l'utilisation globale.

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

curl -H "authorization: your-api-key" \
  "https://api.capgo.app/statistics/user/?from=2024-01-01&to=2024-02-01"

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 /statistiques/d'applications/:app_id/utilisation_du_paquet

Obtenir les statistiques d'utilisation des paquets pour une application spécifique, montrant la répartition des paquets (versions) parmi les utilisateurs sur une période spécifié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

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

{
  "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

Scénarios d'erreurs courants et leurs réponses :

// 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"
}

Utilisations courantes

Suivi de la croissance : Suivre l'évolution du nombre moyen d'utilisateurs sur une période donnée
Optimisation des ressources : Suivre l'utilisation de la mémoire et de la bande passante pour optimiser les coûts
Planification de Capacité: Utilisez les tendances pour planifier les besoins de ressources futurs
Rapports d'utilisation: Générez des rapports d'utilisation périodiques pour les parties prenantes
Analyse de la distribution de la version du paquet (version): Comprenez comment les utilisateurs sont répartis sur différentes versions de l'application avec des statistiques d'utilisation de paquets

Conseils d'analyse

Comparer les périodes: Regardez les tendances mois sur mois ou année sur année
Suivre les ratios: Suivez la bande passante par utilisateur ou le stockage par application
Activer les alertes: Créer des alertes pour des pics inhabituels d'utilisation
Sauvegardes régulières: Exporter les statistiques régulièrement pour une analyse historique
Adoption de la version (bundle): Utiliser l'utilisation des bundles pour suivre les taux d'adoption de nouvelles versions (bundles)

Continuer depuis les Statistiques

Si vous utilisez les Statistiques pour planifier le stockage et la gestion des fichiers, connectez-le avec @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, En utilisant @capgo/capacitor-data-storage-sqlite pour la capacité native dans En utilisant @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-fichier pour les détails d'implémentation dans @capgo/capacitor-fichier, En utilisant @capgo/capacitor-fichier pour la capacité native dans En utilisant @capgo/capacitor-fichier, et @capgo/capacitor-téléchargeur pour les détails d'implémentation dans @capgo/capacitor-téléchargeur.