Statistiken

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

Verständnis der Metriken

• MAU (Monatlich aktive Benutzer)Anzahl der einzigartigen Geräte, die in den letzten 30 Tagen auf Ihre App zugegriffen haben
• SpeicherplatzGesamtgröße aller Pakete und Ressourcen in Byte
• DatenübertragungGesamtdatenübertragung für Paketdownloads in Byte

Gute Praxisen

1. Überprüfen Sie Statistiken regelmäßig, um Wachstum und Nutzungsmuster zu verfolgenRessourcenplanung
2. Verwenden Sie Speicherplatz- und Datenübertragungs-Metriken für die KapazitätsplanungBenutzerbeteiligung
3. __CAPGO_KEEP_0__: Benutzeraktivitäts-Trends verfolgen, um die Nutzerengagement-Trends zu verstehen
4. Kostenverwaltung: Ressourcenverbrauch überwachen, um Kosten zu optimieren

Endpunkte

GET /statistics/app/:app_id/

Statistiken für eine bestimmte App abrufen. 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/

Für eine bestimmte Organisation Statistiken 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"

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 /statistik/nutzer/

Erhalte aggregierte Statistiken über alle Organisationen, denen du Zugriff hast. 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/bundle_usage

Abrufen von Verwendungszahlen für Bundles für eine bestimmte App, die Verteilung von Bundles (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"
}

Gemeinsame Verwendungsfälle

1. Wachstumstracking: Überwache das Wachstum der MAU im Laufe der Zeit
2. Ressourcenoptimierung: Verfolge den Speicherplatz und die Bandbreitennutzung, um Kosten zu optimieren
3. Kapazitätsplanung: Verwende Trends, um zukünftige Ressourcenbedürfnisse zu planen
4. Nutzungsberichte: Erstelle periodische Nutzungsberichte für Stakeholder
5. Paket (Version) Verteilungsanalyse: Verstehen, wie Benutzer über verschiedene App-Pakete (Versionen) verteilt sind, mit Paketnutzungstatistiken

Tipps zur Analyse

1. Zeitraum vergleichen: Schauen Sie sich Monats- oder Jahresschwellenwerte an
2. Verhältnisse verfolgen: Überwachen Sie Bandbreite pro Benutzer oder Speicherplatz pro App
3. Benachrichtigungen einrichten: Erstellen Sie Benachrichtigungen für ungewöhnliche Spitzen in der Nutzung
4. Regelmäßige Sicherungen: Exportieren Sie Statistiken regelmäßig für historische Analyse
5. Paket (Version) - Einführung: Verwenden Sie die Bundle-Nutzung, um die Akzeptanzraten neuer Bundles (Versionen) zu verfolgen