L'API Google Play Developer Reporting ti consente di accedere a metriche, report e informazioni sulla cronologia delle tue app. Per semplificare al massimo l'utilizzo delle API, i set di metriche standardizzano l'accesso alle metriche. Un insieme di metriche è un raggruppamento logico di metriche correlate che condividono attributi comuni (come aggiornamento e granularità) e possono essere interrogate insieme. Un insieme di metriche contiene anche una serie di dimensioni che puoi utilizzare per filtrare o produrre distribuzioni. Se non 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 insieme di metriche può
supportare più granularità (giornaliera, oraria), l'operazione restituisce un valore di aggiornamento
per ogni 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 insieme di metriche, devi utilizzare il metodo personalizzato QUERY per eseguire le 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.
Quando richiedi le cronologie, devi prestare attenzione a richiedere intervalli di date in modo che le dimensioni dell'intervallo di tempo siano inversamente proporzionali alle dimensioni dell'app e al numero di suddivisioni. Ad esempio, un'app di grandi dimensioni deve selezionare meno giorni in una singola richiesta di query per evitare timeout della query causati dalla lettura di troppi dati.
Set di metriche disponibili
L'indice riportato di seguito elenca tutti gli endpoint e i dati associati che puoi richiedere.
| Set di metriche | Descrizione | Metriche supportate |
|---|---|---|
vitals.anrrate |
Contiene dati ANR combinati con dati sull'utilizzo per produrre una metrica normalizzata indipendente dai conteggi degli utenti. |
anrRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione
che hanno riscontrato almeno un errore ANR. anrRate7dUserWeighted (google.type.Decimal): la media ponderata in base all'utente della metrica anrRate nei 7 giorni fino alla data inclusa. anrRate28dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica anrRate nei 28 giorni fino alla data inclusa. userPerceivedAnrRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione che hanno riscontrato almeno un errore ANR percepito dall'utente. Attualmente vengono conteggiati solo gli errori ANR di tipo "Invio input". userPerceivedAnrRate7dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica userPerceivedAnrRate nei 7 giorni fino alla data inclusa. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): la media ponderata in base all'utente della metrica userPerceivedAnrRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.crashrate |
Contiene i dati sugli arresti anomali combinati con i dati sull'utilizzo per produrre una metrica normalizzata indipendente dal numero di utenti. |
crashRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione
che hanno riscontrato almeno un arresto anomalo. crashRate7dUserWeighted (google.type.Decimal): la media ponderata in base all'utente della metrica crashRate nei 7 giorni fino alla data inclusa. crashRate28dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica crashRate nei 28 giorni fino alla data inclusa. userPerceivedCrashRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione che hanno riscontrato almeno un arresto anomalo mentre l'app era in uso attivo. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): la media ponderata in base all'utente della metrica userPerceivedCrashRate nei 7 giorni fino alla data inclusa. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): la media ponderata in base agli utenti della metrica userPerceivedCrashRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.lmkrate
|
Contiene i dati LMK (interruzione per memoria insufficiente) combinati con i dati sull'utilizzo per produrre una metrica normalizzata indipendente dai conteggi degli utenti. |
userPerceivedLmkRate (google.type.Decimal): percentuale di utenti unici nel
periodo di aggregazione che hanno riscontrato almeno un'interruzione per memoria insufficiente (LMK) mentre
utilizzavano attivamente la tua app. Un'app è considerata in uso attivo se mostra
un'attività o esegue un servizio in primo piano. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica userPerceivedLmkRate nei 7 giorni fino alla data inclusa. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): La media ponderata in base all'utente della metrica userPerceivedLmkRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.excessivewakeuprate |
Contiene i dati dei conteggi di riattivazione di AlarmManager combinati con i dati sullo stato del processo per produrre una metrica normalizzata indipendente dai conteggi degli utenti. |
excessiveWakeupRate (google.type.Decimal): percentuale di utenti distinti nel
periodo di aggregazione che hanno avuto più di 10 wakeup all'ora.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica excessiveWakeupRate nei 7 giorni fino alla data inclusa. excessiveWakeupRate28dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica excessiveWakeupRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.stuckbackgroundwakelockrate |
Contiene dati sulla durata del wakelock di PowerManager combinati con i dati sullo stato del processo per produrre una metrica normalizzata indipendente dal numero di utenti. |
stuckBgWakelockRate (google.type.Decimal): percentuale di utenti distinti nel
periodo di aggregazione che hanno avuto un wakelock mantenuto in background per più di 1 ora.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): la media ponderata per utente
della metrica stuckBgWakelockRate nei 7 giorni fino alla data inclusa. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): La media ponderata per utente della metrica stuckBgWakelockRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.slowstartuprate |
Contiene dati sull'avvio lento delle app suddivisi per tipo di avvio (freddo, caldo, caldo con app e attività in memoria). |
slowStartRate (google.type.Decimal): percentuale di utenti unici nel
periodo di aggregazione che hanno avuto un evento di avvio lento.
slowStartRate7dUserWeighted (google.type.Decimal): la media ponderata per utente
della metrica slowStartRate nei 7 giorni fino alla data inclusa. slowStartRate28dUserWeighted (google.type.Decimal): la media ponderata per utente della metrica slowStartRate nei 28 giorni fino alla data inclusa. distinctUsers (google.type.Decimal): il numero approssimativo di utenti per i quali i dati erano disponibili nel periodo di aggregazione. |
vitals.errors.counts |
Contiene conteggi dei report sugli errori non normalizzati. |
Nota:questa risorsa è al momento disponibile solo nella versione alpha v1 dell'API. errorReportCount (google.type.Decimal): conteggio assoluto delle singole segnalazioni di errori che sono state ricevute per un'app. |
Dimensioni
Ogni set di metriche supporta un insieme distinto di dimensioni per il filtraggio e le suddivisioni. Consulta l'indice delle dimensioni riportato di seguito per un elenco delle dimensioni disponibili nell'API.
| Dimensione | Descrizione |
|---|---|
versionCode |
Il codice versione dell'app in esecuzione sul dispositivo dell'utente al momento dell'acquisizione dei dati. Il valore stringa di questa dimensione può essere analizzato come numero intero. Per ulteriori dettagli sul funzionamento del controllo delle versioni delle app su Android, consulta questa pagina. |
countryCode |
Identificatore del paese o della regione dell'utente in base al suo indirizzo IP, rappresentato come codice ISO-3166 di due lettere (ad es. US per gli Stati Uniti). |
Dimensioni dispositivo
Queste sono le 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 numero intero. Consulta questa pagina per 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 un particolare 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 principale del dispositivo, ad es. Samsung. Vedi qui. |
deviceSocModel |
Il nome del modello del system-on-chip principale del dispositivo, ad es. "Exynos 2100". Vedi qui. |
deviceCpuMake |
Marca della CPU del dispositivo, ad es. Qualcomm. |
deviceCpuModel |
Modello della CPU del dispositivo, ad es. "Kryo 240". |
deviceGpuMake |
Marca della GPU del dispositivo, ad es. ARM. |
deviceGpuModel |
Modello della GPU del dispositivo, ad es. Mali. |
deviceGpuVersion |
Versione della GPU del dispositivo, ad es. T750. |
deviceVulkanVersion |
La versione Vulkan del dispositivo, ad es. "4198400". |
deviceGlEsVersion |
Versione OpenGL ES del dispositivo, ad es. "196610". |
deviceScreenSize |
Dimensioni dello schermo del dispositivo, ad esempio NORMALE, GRANDE. |
deviceScreenDpi |
Densità schermo del dispositivo, ad es. mdpi, hdpi. |