Analisi delle statistiche

Il endpoint delle statistiche fornisce analisi dettagliate sulle tue app e organizzazioni. Puoi tracciare gli Utenti Attivi Mensili (MAU), l'uso dello spazio di archiviazione e la consumazione di banda in diversi periodi di tempo. Queste informazioni sono essenziali per monitorare la crescita delle app, l'uso delle risorse e pianificare la capacità.

Capire i Metriche

• MAU (Utenti Attivi Mensili): Numero di dispositivi unici che hanno acceso la tua app negli ultimi 30 giorni
• Spazio di archiviazione: Dimensione totale di tutti i pacchetti e le risorse archiviate in byte
• Capacità di banda: Totale trasferimento dei dati per i download dei pacchetti in byte

Pratiche Ottimali

1. Monitoraggio Regolare: Controlla le statistiche periodicamente per tracciare la crescita e i modelli di utilizzo
2. Pianificazione delle Risorse: Utilizza le metriche di archiviazione e capacità di 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: Monitora l'utilizzo delle risorse per ottimizzare i costi

Endpoint

GET /statistiche/app/:app_id/

Ottieni le 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/organizzazione/: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
  }
]

GET /statistiche/utente/

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

Risposta di esempio

[
  {
    "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 /statistiche/app/:app_id/uso pacchetti

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

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

Richiesta di esempio

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"

Risposta di esempio

{
  "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: Seguire l'uso di archiviazione e banda per ottimizzare i costi
3. Pianificazione della Capacità: Usare le tendenze per pianificare le future esigenze di risorse
4. Relazioni di Utilizzo: Generare relazioni di utilizzo periodiche per gli stakeholder
5. Analisi della Distribuzione del Pacchetto (versione): Capire come gli utenti sono distribuiti su diverse versioni dell'applicazione con statistiche di utilizzo dei pacchetti

Suggerimenti per l'Analisi

1. Confronta PeriodiVisualizza le tendenze mese dopo mese o anno dopo anno
2. Traccia RapportiMonitora la banda per utente o lo spazio di archiviazione per app
3. Imposta AvvisiCrea avvisi per picchi insoliti nell'uso
4. Backup RegolariEsporta statistiche regolarmente per l'analisi storica
5. Adozione del Pacchetto (versione)Utilizza l'utilizzo dei pacchetti per tracciare le percentuali di adozione dei nuovi pacchetti (versioni)

Continua da Statistiche

If sei stai utilizzando Statistiche per pianificare lo storage e il trattamento dei file, connettilo con @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzando @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-data-storage-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 i dettagli di implementazione in @capgo/capacitor-uploader.