Statistiken

Die Statistik-Endpunkte liefern detaillierte Analysen zu Ihren Anwendungen und Organisationen. Sie können monatlich aktive Benutzer (MAU), Speicherplatznutzung und Bandbreitenverbrauch über verschiedene Zeitabschnitte verfolgen. Diese Daten sind für die Überwachung der Anwendungsvergrößerung, der Ressourcenverwendung und die Planung der Kapazität unerlässlich.

Die Metriken verstehen

• MAU (Monatlich aktive Benutzer)Anzahl der einzigartigen Geräte, die in den letzten 30 Tagen auf Ihre App zugegriffen haben
• SpeicherplatzGröße aller Pakete und Ressourcen in Byte
• BandbreiteGröße aller heruntergeladenen Pakete in Byte

Best Practices

1. Überprüfen Sie die Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgenRessourcenplanung
2. Verwenden Sie die Speicherplatz- und Bandbreitenmetriken zur KapazitätsplanungBenutzerbeteiligung
3. Benutzerbeteiligung: Erfassen Sie MAU, um Trends der Nutzerbeteiligung zu verstehen
4. Kostenverwaltung: Überwachen Sie die Ressourcenverwendung, um Kosten zu optimieren

Endpunkte

GET /statistics/app/:app_id/

Ermitteln Sie Statistiken für eine bestimmte App. Dieser Endpunkt ist nützlich, um die Leistung einzelner Apps zu überwachen

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"

Beispielantwort

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

Organisationsstatistiken abrufen. Nützlich für die Überwachung der Nutzung auf 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"

Beispielantwort

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

Erhalte aggregierte Statistiken über alle Organisationen, zu denen du Zugriff hast. Ideal 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 /statistics/app/:app_id/bundle_usage

Abrufen von Verwendungszahlen für ein bestimmtes App, die Verteilung von Paketen (Versionen) unter Benutzern über einen bestimmten Zeitraum zeigt.

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)
}

Beispielanfrage

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"

Beispielergebnis

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

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

Häufige Verwendungsfälle

1. Wachstumsverfolgung: Wachstum des MAU über die Zeit verfolgen
2. Ressourcenoptimierung: Speicherplatz und Bandbreitenverbrauch verfolgen, um Kosten zu optimieren
3. Kapazitätsplanung: Trends nutzen, um zukünftige Ressourcenbedürfnisse zu planen
4. Nutzungsberichte: Periodische Nutzungsberichte für Stakeholder erstellen
5. Verteilungsanalyse der Bundle (Version): Erfassen Sie, wie sich die Benutzer auf verschiedene App-Pakete (Versionen) verteilen, mit Hilfe von Statistiken zum Paketnutzung

Tipps zur Analyse

1. Vergleiche von Zeiträumen: Schauen Sie sich Monats- oder Jahresschwankungen an
2. Ratios verfolgen: Überwachen Sie die Bandbreite pro Benutzer oder die Speicherung pro App
3. Benachrichtigungen einrichten: Erstellen Sie Benachrichtigungen für ungewöhnliche Spitzen im Nutzungsverhalten
4. Regelmäßige Sicherungen: Exportieren Sie Statistiken regelmäßig für eine historische Analyse
5. Paket (Version) - Einführung: Verwenden Sie die Bundle-Nutzung, um die Akzeptanzraten neuer Bundle (Versionen) zu verfolgen.

Fortsetzen von Statistiken

Wenn Sie Statistiken verwenden, um den Speicher und die Dateihandling zu planen, verbinden Sie es mit @capgo/capacitor-data-storage-sqlite zur Implementierungsdetail in @capgo/capacitor-data-storage-sqlite, Verwenden Sie @capgo/capacitor-data-storage-sqlite zur nativen Fähigkeit in Verwenden Sie @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file zur Implementierungsdetail in @capgo/capacitor-file, Mit @capgo/capacitor-Datei für die native Fähigkeit in Mit @capgo/capacitor-Datei, und capgo/capacitor-Uploader für die Implementierungsdetails in capgo/capacitor-Uploader.