Statistiken

Die Statistik-Endpunkte liefern detaillierte Analysen zu Ihren Apps und Organisationen. Sie können die monatlichen aktiven Benutzer (MAU), den Speicherbedarf und die Bandbreitenverbrauch über verschiedene Zeitabschnitte verfolgen. Diese Daten sind für die Überwachung der App-Wachstum, Ressourcenverbrauch und die Planung der Kapazität unerlässlich.

Verständnis der Metriken

• MAU (Monatlich aktive Benutzer): Anzahl der einzigartigen Geräte, die Ihre App in den letzten 30 Tagen zugriffen haben
• Speicherplatz: Gesamter Speicherplatz aller Pakete und Ressourcen in Bytes
• Bandbreite: Gesamter Datentransfer für die Herunterladen von Paketen in Bytes

Best Practices

1. Regelmäßige Überwachung: Überprüfen Sie Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgen
2. Ressourcenplanung: Verwenden Sie Storage- und Bandbreitenmetriken für die Kapazitätsplanung
3. Benutzerbeteiligung: Verfolgen Sie MAU, um Trends der Benutzerbeteiligung zu verstehen
4. Kostenmanagement: Überwachen Sie die Ressourcenverwendung, um Kosten zu optimieren

Endpunkte

GET /statistiken/anwendung/:app_id/

Statistiken für eine bestimmte App abrufen. Diese Endpunkt ist nützlich für die Überwachung der individuellen App-Performance.

Abfrageparameter

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Beispielanfrage

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

Beispielergebnis

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

Statistiken für eine bestimmte Organisation abrufen. Nützlich für die Überwachung der Organisationsebene.

Abfrageparameter

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
}

Beispielanfrage

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"

Beispielergebnis

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

Gesammelte Statistiken aus allen Organisationen, auf die Sie Zugriff haben. Perfekt für die Überwachung der Gesamtverwendung.

Abfrageparameter

interface StatsQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Beispielanfrage

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

Beispielantwort

[
  {
    "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 /statistik/app/:app_id/paketnutzung

Zurückliegende Paketnutzungsstatistiken für eine bestimmte App anzeigen, die Verteilung von Paketen (Versionen) unter Benutzern über einen bestimmten Zeitraum.

Abfrageparameter

interface BundleUsageQuery {
  from: Date  // Start date for the statistics (format: YYYY-MM-DD)
  to: Date    // End date for the statistics (format: YYYY-MM-DD)
}

Zwischenablage kopieren

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"

Beispielantwort

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

Fehlerbehandlung

Häufige Fehlerfälle und ihre Antworten:

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

Gemeinsame Verwendungsfälle

1. WachstumsverfolgungMAU-Wachstum über die Zeit verfolgen
2. Ressourcenoptimierung: Speicherplatz- und Bandbreitenverbrauch verfolgen, um Kosten zu optimieren
3. Kapazitätsplanung: Trends nutzen, um zukünftige Ressourcenbedarfe zu planen
4. Nutzungsberichte: Periodische Nutzungsberichte für Stakeholder erstellen
5. Bundle (Version) Verteilungsanalyse: Erfassen, wie Benutzer über verschiedene App-Bundles (Versionen) verteilt sind, mit Statistiken zum Bundle-Verbrauch

Tipps zur Analyse

1. Vergleiche von Zeiträumen: Monats- oder jährliche Trends vergleichen
2. Ratios verfolgen: Überwache die Bandbreite pro Benutzer oder den Speicher pro App
3. Schutzmeldungen einrichten: Erstelle Warnungen für ungewöhnliche Spitzen im Nutzungsverhalten
4. Regelmäßige Sicherungen: Exportiere Statistiken regelmäßig für historische Analyse
5. Bundle-(Version)-Einführung: Verwende die Bundle-Nutzung, um die Einführungsrate neuer Bundles (Versionen) zu verfolgen

Fortsetzung aus Statistiken

Wenn Sie " Statistiken " verwenden, um den Speicher und die Dateimanagement zu planen, verbinden Sie es mit @capgo/capacitor-Speicherung in einer Datenbank für die Implementierungsdetails in @capgo/capacitor-Speicherung in einer Datenbank Verwendung von @capgo/capacitor-Speicherung in einer Datenbank für die native Fähigkeit in Verwendung von @capgo/capacitor-Speicherung in einer Datenbank @capgo/capacitor-Datei für die Implementierungsdetails in @capgo/capacitor-Datei Verwendung von @capgo/capacitor-Datei für die native Fähigkeit in Verwendung von @capgo/capacitor-Datei und @capgo/capacitor-Uploader für die Implementierungsdetails in @capgo/capacitor-Uploader