Statistics

Il endpoint delle statistiche fornisce analisi dettagliate sulle tue app e organizzazioni. Puoi monitorare gli Utenti Attivi Mensili (UAM), l'utilizzo dello spazio di archiviazione e la consumazione di banda in diversi periodi di tempo. Questa informazione è essenziale per monitorare la crescita delle app, l'utilizzo delle risorse e pianificare la capacità.

Capire i dati statistici

• UAM (Utenti Attivi Mensili): Numero di dispositivi unici che hanno acceso la tua app negli ultimi 30 giorni
• Archiviazione: Dimensione totale di tutti i bundle e risorse memorizzati in byte
• Bandwidth: Totale trasferimento dei dati per i download dei bundle in byte

Pratiche Ottimali

1. Monitoraggio RegolareControlla le statistiche periodicamente per monitorare l'evoluzione e i modelli di utilizzo.
2. Pianificazione delle RisorseUtilizza metriche di archiviazione e banda per la pianificazione della capacità
3. Impegno dell'Utente: Traccia il MAU per comprendere le tendenze di impegno dell'utente
4. Gestione dei Costi: Monitorare l'utilizzo delle risorse per ottimizzare i costi

Endpoint

GET /statistiche/app/:app_id/

Ottieni statistiche per un'app specifica. Questo endpoint è utile per monitorare il rendimento individuale di un'app.

Parametri di query

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

Esempio di richiesta

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

Esempio di Risposta

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

Ottieni statistiche per un'organizzazione specifica. Utile per monitorare l'utilizzo a livello di organizzazione.

Parametri di query

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
}

Esempio di richiesta

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"

Esempio di Risposta

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

Ottieni /statistiche/utente/

Ottieni statistiche aggregate su tutte le organizzazioni a cui hai accesso. Perfetto per il monitoraggio dell'uso generale.

Parametri di Query

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

Esempio di Richiesta

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

Esempio di risposta

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

Ottieni statistiche sull'uso dei bundle per un'app specifica, mostrando la distribuzione dei bundle (versioni) tra gli utenti in un periodo specifico.

Parametri di query

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

Esempio di Richiesta

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"

Esempio di Risposta

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

Gestione degli Errori

Scenari di errore comuni e relative risposte:

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

Utilizzo comune

1. Tracciamento della crescita: Monitorare il crescita del MAU nel tempo
2. Optimizzazione delle risorse: Tracciare l'uso di archiviazione e banda per ottimizzare i costi
3. Pianificazione della capacitàUsa le tendenze per pianificare le future esigenze di risorse
4. Relazioni di utilizzo: Generare relazioni di utilizzo periodiche per i stakeholder
5. Analisi della distribuzione del pacchetto (versione): Comprendere come gli utenti sono distribuiti across different app bundles (versions) con statistiche di utilizzo del pacchetto

Consigli per l'analisi

1. Confronta PeriodiEsegui una comparazione tra le tendenze mensili o annuali
2. Segui le Proporzioni: Monitora la banda per utente o lo spazio di archiviazione per app
3. Imposta le Allerte: Crea allerte per picchi insoliti nell'uso
4. Backup Regolari: Esporta statistiche regolarmente per l'analisi storica
5. Adozione del Pacchetto (versione)Usa l'utilizzo dei bundle per tracciare le percentuali di adozione dei nuovi bundle (versioni)

Continua dall'Analisi delle Statistiche

Se stai utilizzando Statistiche per pianificare lo storage e il trattamento dei file, connettilo con @capgo/capacitor-dati-di-archiviazione-sqlite per i dettagli di implementazione in @capgo/capacitor-dati-di-archiviazione-sqlite, Utilizzando @capgo/capacitor-dati-di-archiviazione-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-dati-di-archiviazione-sqlite, @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Utilizzando @capgo/capacitor-file per la capacità nativa in Utilizzando @capgo/capacitor-file, e @capgo/capacitor-uploader per la dettagliata implementazione in @capgo/capacitor-uploader.