Statistiche
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Gli endpoint Statistics forniscono analisi dettagliate sulle tue app e organizzazioni. Puoi monitorare gli Utenti Attivi Mensili (MAU), l'utilizzo dello storage e il consumo di banda in diversi periodi. Questi dati sono essenziali per monitorare la crescita dell'app, l'utilizzo delle risorse e la pianificazione della capacità.
Capire le metriche
Sezione intitolata “Comprendere le metriche”- MAU (Utenti Attivi Mensili): Numero di dispositivi univoci che hanno acceduto alla tua app negli ultimi 30 giorni
- Archiviazione: Dimensione totale di tutti i bundle e delle risorse archiviate in byte
- Banda: Trasferimento dati totale per i download dei bundle in byte
Best practice
Sezione “Best practice”- Monitoraggio regolare: Controlla le statistiche periodicamente per tracciare crescita e modelli di utilizzo
- Pianificazione delle risorse: Usa le metriche di storage e banda per la pianificazione della capacità
- Engagement utenti: Monitora i MAU per capire le tendenze di engagement degli utenti
- Gestione dei costi: Monitora l'utilizzo delle risorse per ottimizzare i costi
Endpoint
Sezione intitolata “Endpoints”GET /statistics/app/:app_id/
Sezione intitolata “GET /statistics/app/:app_id/”Ottieni le statistiche di un'app specifica. Questo endpoint è utile per monitorare le performance della singola app.
Parametri di query
Sezione intitolata “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
Sezione intitolata “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"Risposta di esempio
Sezione intitolata “Risposta di esempio”[ { "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/
Sezione intitolata “GET /statistics/org/:org_id/”Ottieni le statistiche per un'organizzazione specifica. Utile per monitorare l'utilizzo a livello di organizzazione.
Parametri di query
Sezione intitolata “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
Sezione intitolata “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"Risposta di esempio
Sezione intitolata “Risposta di esempio”[ { "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/
Sezione intitolata “GET /statistics/user/”Ottieni statistiche aggregate per tutte le organizzazioni a cui hai accesso. Ideale per monitorare l'utilizzo complessivo.
Parametri di query
Sezione intitolata “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
Sezione intitolata “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
Sezione intitolata “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 /statistics/app/:app_id/bundle_usage
Sezione intitolata “GET /statistics/app/:app_id/bundle_usage”Ottieni le statistiche sull'utilizzo dei bundle per un'app specifica, mostrando la distribuzione dei bundle (versioni) tra gli utenti in un determinato periodo.
Parametri di query
Sezione intitolata “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
Sezione intitolata “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"Risposta di esempio
Sezione intitolata “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
Sezione “Gestione degli errori”Tutti gli errori seguono il formato standard descritto nella Panoramica di API.
Scenari di errore comuni e relative risposte:
// The API key cannot read this app (HTTP 401){ "error": "no_access_to_app", "message": "No access to app", "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }}
// The API key cannot read this organization (HTTP 401){ "error": "no_access_to_organization", "message": "No access to organization", "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }}
// Organization statistics require an active plan (HTTP 402){ "error": "subscription_required", "message": "Organization subscription required or plan invalid", "moreInfo": { "orgId": "046a36ac-e03c-4590-9257-bd6c9dba9ee8", "isPayingAndGoodPlan": false }}
// User statistics when the user belongs to no organization (HTTP 401){ "error": "no_organizations_found", "message": "No organizations found", "moreInfo": { "data": "6aa76066-55ef-4238-ade6-0b32334a4097" }}Casi d'uso comuni
Sezione intitolata “Casi d'uso comuni”- Monitoraggio della crescita: Monitora la crescita dei MAU nel tempo
- Ottimizzazione delle risorse: Monitora l'uso di storage e banda per ottimizzare i costi
- Pianificazione della capacità: Usa i trend per pianificare il fabbisogno futuro di risorse
- Report di utilizzo: Genera report periodici sull'utilizzo per gli stakeholder
- Analisi della distribuzione dei bundle (versioni): Scopri come sono distribuiti gli utenti tra i diversi bundle (versioni) dell'app con le statistiche di utilizzo dei bundle
Suggerimenti per l'analisi
Sezione intitolata “Consigli per l'analisi”- Confronta periodi: Analizza i trend mensili o annuali
- Monitora i rapporti: Monitora la banda per utente o lo storage per app
- Imposta alert: Crea alert per picchi di utilizzo anomali
- Backup regolari: Esporta periodicamente le statistiche per analisi storiche
- Adozione dei bundle (versioni): Usa i dati di utilizzo per tracciare l'adozione di nuovi bundle (versioni)
Continua dalle statistiche
Sezione intitolata “Continua da Statistics”Se stai usando Statistiche per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Utilizzo di @capgo/capacitor-file per la funzionalità nativa in Usare @capgo/capacitor-file, e @capgo/capacitor-uploader per i dettagli implementativi in @capgo/capacitor-uploader.
Salute dei rilasci, errori e build native
Sezione intitolata “Salute dei rilasci, errori e build native”Usa il monitoraggio di API per la diagnostica di native e updater, log con metadati, statistiche del dashboard di rilascio live, stato e snapshot dei log delle build native. Queste letture sono esposte anche da entrambi i server MCP dell'account.
GET /statistics/app/:app_id/native_usage
Sezione intitolata “GET /statistics/app/:app_id/native_usage”Legge l'adozione della versione nativa e il conteggio dei dispositivi attivi giornalieri per from e to date. La risposta include labels, grafico datasets, latestVersion, activeDevices, previousPeriodActiveDevices, e dailyPlatformActive.
dailyPlatformActive è un oggetto contenente labels come stringhe di data e android, ios, electron, unknown, e total come array di numeri allineati a quelle date. Non è un array di righe. Le letture secondarie dei dispositivi attivi possono degradarsi a dati vuoti se non disponibili; i valori vuoti non dimostrano che non ci siano dispositivi attivi.