Questa pagina è stata tradotta dall'API Cloud Translation.

Introduzione ai set di metriche

L'API Google Play Developer Reporting ti consente di accedere a metriche, report e informazioni sulle tempistiche delle tue app. Per semplificare il più possibile l'utilizzo dell'API, gli insiemi di metriche standardizzano l'accesso alle metriche. Un set di metriche è un raggruppamento logico di metriche correlate che condividono attributi comuni (come aggiornamento e granularità) e che possono essere oggetto di query. Un insieme di metriche contiene anche una serie di dimensioni che puoi utilizzare per filtrare o produrre le suddivisioni. Salvo diversamente specificato, tutte le metriche possono essere suddivise o filtrate in base a tutte le dimensioni disponibili.

Aggiornamento

Ogni risorsa del set di metriche offre un metodo GET standard per recuperare la data e l'ora dell'ultimo punto dati disponibile, noto come aggiornamento. Poiché un set di metriche può supportare più granularità (giornaliera, oraria), l'operazione restituisce un solo valore di aggiornamento per granularità supportata.

Puoi utilizzare il valore di aggiornamento direttamente come endpoint in un intervallo di tempo della query.

Query sui dati

Per accedere ai dati in un set di metriche, devi utilizzare il metodo QUERY personalizzato per inviare query. Ogni query deve specificare una granularità e un intervallo di tempo. Insieme alle metriche a cui vuoi accedere, devi specificare le dimensioni da utilizzare per suddividere le aggregazioni.

Presta attenzione quando richiedi tempistiche per richiedere intervalli di date, in modo che le dimensioni dell'intervallo di tempo siano inversamente proporzionali a quelle della tua app e al numero di suddivisioni. Ad esempio, per un'app di grandi dimensioni è necessario selezionare meno giorni in una singola richiesta di query per evitare timeout della query causati dalla lettura di troppi dati.

Insiemi di metriche disponibili

L'indice seguente elenca tutti gli endpoint e i dati associati che puoi richiedere.

Set di metriche	Descrizione	Metriche supportate
`vitals.anrrate`	Contiene i dati ANR combinati con i dati sull'utilizzo per produrre una metrica normalizzata indipendente dal conteggio degli utenti.	anrRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che hanno riscontrato almeno un errore ANR. anrRate7dUserponder (google.type.Decimal): la media ponderata in base all'utente della metrica anrRate nei 7 giorni fino alla data inclusa. anrRate28dUserponder (google.type.Decimal): la media ponderata dall'utente della metrica anrRate nei 28 giorni precedenti la data inclusa. userPerceivedAnrRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che hanno riscontrato almeno un ANR percepito dall'utente. Attualmente vengono conteggiati gli errori ANR di "Invio della spedizione". userPerceivedAnrRate7dUserweight (google.type.Decimal): media media ponderata in base alla metrica utentePerceivedAnrRate nei 7 giorni fino alla data inclusa. userPerceivedAnrRate28dUserweight (google.type.Decimal): media media ponderata in base alla metrica utentePerceivedAnrRate nei 28 giorni successivi alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali erano disponibili dati nel periodo di aggregazione.
`vitals.crashrate`	Contiene dati sugli arresti anomali combinati con quelli sull'utilizzo per produrre una metrica normalizzata indipendente dal conteggio degli utenti.	crashRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che hanno riscontrato almeno un arresto anomalo. crashRate7dUserponder (google.type.Decimal): la media ponderata in base all'utente della metrica CrashlyticsRate in 7 giorni fino alla data inclusa. crashRate28dUserweight (google.type.Decimal): media media ponderata dagli utenti della metrica CrashlyticsRate in 28 giorni fino alla data inclusa. userPerceivedCrashRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che ha riscontrato almeno un arresto anomalo mentre l'app era in uso attivo. userPerceivedCrashRate7dUserweight (google.type.Decimal): la media ponderata in base alla metrica utentePerceivedCrashRate nei 7 giorni fino alla data inclusa. userPerceivedCrashRate28dUserweight (google.type.Decimal): media media ponderata in base alla metrica utentePerceivedCrashRate, nei 28 giorni successivi alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali erano disponibili dati nel periodo di aggregazione.
`vitals.excessivewakeuprate`	Contiene i dati dei conteggi wakeup di AlarmManager combinati con i dati sullo stato del processo per produrre una metrica normalizzata indipendente dai conteggi degli utenti.	Tasso di wakeup eccessivo (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che hanno avuto più di 10 wakeup all'ora. eccessiveWakeupRate7dUserweight (google.type.Decimal): la media ponderata in base all'utente della metrica wakeupRate negli ultimi 7 giorni fino alla data inclusa. eccessivoWakeupRate28dUserweight (google.type.Decimal): media media ponderata, dall'utente, della metrica eccessivamenteWakeupRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali erano disponibili dati nel periodo di aggregazione.
`vitals.stuckbackgroundwakelockrate`	Contiene i dati sulla durata del wakelock di PowerManager combinati con i dati sullo stato del processo per produrre una metrica normalizzata indipendente dal conteggio degli utenti.	stuckBgWakelockRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione che avevano un wakelock in background per più di un'ora. stuckBgWakelockRate7dUserweight (google.type.Decimal): la media ponderata in base all'utente della metrica bloccataBgWakelockRate nei 7 giorni fino alla data inclusa. stuckBgWakelockRate28dUserweight (google.type.Decimal): media media ponderata in base all'utente della metrica bloccataBgWakelockRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali erano disponibili dati nel periodo di aggregazione.
`vitals.slowstartuprate`	Contiene dati di avvio lenti suddivisi per tipo di avvio dell'app (freddo, caldo, caldo).	slowStartRate (google.type.Decimal): percentuale di utenti distinti nel periodo di aggregazione con un evento di avvio lento. slowStartRate7dUserponder (google.type.Decimal): la media ponderata in base all'utente della metrica slowStartRate nei 7 giorni fino alla data inclusa. slowStartRate28dUserweight (google.type.Decimal): media media ponderata in base all'utente della metrica slowStartRate nei 28 giorni precedenti la data. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali erano disponibili dati nel periodo di aggregazione.
`vitals.errors.counts`	Contiene il numero di report di errore non normalizzato.	Nota: al momento questa risorsa è disponibile solo nella versione alpha v1 dell'API. errorReportCount (google.type.Decimal): il conteggio assoluto dei singoli report sugli errori ricevuti per un'app.

Dimensioni

Ogni insieme di metriche supporta un insieme distinto di dimensioni per i filtri e le suddivisioni. Consulta l'indice delle dimensioni riportato di seguito per un elenco delle dimensioni disponibili nell'API.

Dimensione	Descrizione
`versionCode`	Il codice di versione dell'app che era in esecuzione sul dispositivo dell'utente al momento dell'acquisizione dei dati. Il valore stringa di questa dimensione può essere analizzato come un numero intero. Visita questa pagina per avere ulteriori dettagli sul funzionamento del controllo delle versioni dell'app su Android.
`countryCode`	Identificatore del paese o della regione dell'utente in base al suo indirizzo IP, rappresentato da un codice ISO-3166 di due lettere (ad es. US per gli Stati Uniti).

Dimensioni dispositivo

Si tratta delle dimensioni specifiche del dispositivo e delle sue caratteristiche software e hardware.

Dimensione	Descrizione
`apiLevel`	Il livello API di Android in esecuzione sul dispositivo dell'utente al momento dell'acquisizione dei dati. Il valore stringa di questa dimensione può essere analizzato come un numero intero. Visita questa pagina per consultare l'elenco delle release di Android e la loro mappatura ai livelli API.
`deviceModel`	Identificatore di un particolare modello di dispositivo, come definito dal catalogo dei dispositivi di Play Console.
`deviceType`	Identificatore di uno specifico fattore di forma del dispositivo utilizzato dal catalogo dei dispositivi di Play Console.
`deviceRamBucket`	RAM del dispositivo, in MB, in bucket (3 GB, 4 GB e così via).
`deviceSocMake`	La marca del system on-chip del dispositivo, ad es. Samsung. Leggi qui.
`deviceSocModel`	Il nome del modello del system on chip principale del dispositivo, ad es. "Exynos 2100" Leggi qui.
`deviceCpuMake`	Marca la CPU del dispositivo, ad esempio Qualcomm,
`deviceCpuModel`	Modello della CPU del dispositivo, ad esempio "Kryo 240".
`deviceGpuMake`	Crea la GPU del dispositivo, ad esempio ARM.
`deviceGpuModel`	Modello della GPU del dispositivo, ad esempio Mali
`deviceGpuVersion`	Versione della GPU del dispositivo, ad esempio T750.
`deviceVulkanVersion`	Versione Vulkan del dispositivo, ad esempio "4198400".
`deviceGlEsVersion`	Versione OpenGL ES del dispositivo, ad esempio "196610".
`deviceScreenSize`	Dimensioni dello schermo del dispositivo, ad esempio NORME, GRANDI.
`deviceScreenDpi`	Densità schermo del dispositivo, ad esempio mdpi, hdpi.