Statistiken

Die Statistiken-Endpunkte bieten detaillierte Analysen zu Ihren Apps und Organisationen. Sie können monatlich aktive Benutzer (MAU), Speichernutzung und Bandbreitenverbrauch über verschiedene Zeiträume hinweg verfolgen. Diese Daten sind für die Überwachung des App-Wachstums, der Ressourcennutzung und der Planungskapazität unerlässlich.

Die Metriken verstehen

MAU (monatlich aktive Benutzer): Anzahl der eindeutigen Geräte, die in den letzten 30 Tagen auf Ihre App zugegriffen haben
Speicher: Gesamtgröße aller gespeicherten Bundles und Ressourcen in Bytes
Bandbreite: Gesamtdatenübertragung für Bundle-Downloads in Bytes

Bewährte Methoden

Regelmäßige Überwachung: Überprüfen Sie die Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgen
Ressourcenplanung: Verwenden Sie Speicher- und Bandbreitenmetriken für die Kapazitätsplanung
Benutzerengagement: Verfolgen Sie MAU, um Trends beim Benutzerengagement zu verstehen
Kostenmanagement: Überwachen Sie die Ressourcennutzung, um die Kosten zu optimieren

Endpunkte

GET /statistics/app/:app_id/

Rufen Sie Statistiken für eine bestimmte App ab. Dieser Endpunkt ist nützlich für die Überwachung der Leistung einzelner Apps.

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/

Rufen Sie Statistiken für eine bestimmte Organisation ab. 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/

Erhalten Sie aggregierte Statistiken für alle Organisationen, auf die Sie Zugriff haben. Perfekt für die allgemeine Nutzungsüberwachung.

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

Erhalten Sie Bundle-Nutzungsstatistiken für eine bestimmte App, die die Verteilung von Bundles (Versionen) unter Benutzern über einen bestimmten Zeitraum anzeigen.

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"

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 Fehlerszenarien 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 Anwendungsfälle

Wachstumsverfolgung: Überwachen Sie das MAU-Wachstum im Laufe der Zeit
Ressourcenoptimierung: Verfolgen Sie die Speicher- und Bandbreitennutzung, um die Kosten zu optimieren
Kapazitätsplanung: Nutzen Sie Trends, um den zukünftigen Ressourcenbedarf zu planen
Nutzungsberichte: Erstellen Sie regelmäßige Nutzungsberichte für Stakeholder
Bundle (version) Distribution Analysis: Understand how users are distributed across different app bundles (versions) with bundle usage statistics

Tipps zur Analyse

Zeiträume vergleichen: Sehen Sie sich die Trends im Monats- oder Jahresvergleich an
Track-Verhältnisse: Überwachen Sie die Bandbreite pro Benutzer oder Speicher pro App
Benachrichtigungen festlegen: Erstellen Sie Benachrichtigungen für ungewöhnliche Nutzungsspitzen
Regelmäßige Backups: Exportieren Sie regelmäßig Statistiken zur historischen Analyse
Bundle-(Versions-)Annahme: Verwenden Sie die Bundle-Nutzung, um die Akzeptanzraten neuer Bundles (Versionen) zu verfolgen.