Method: vitals.crashrate.query

Esegue una query sulle metriche nel set di metriche.

Richiesta HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa.

Formato: apps/{app}/crashRateMetricSet

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Campi
timelineSpec

object (TimelineSpec)

Specifica dei parametri di aggregazione della sequenza temporale.

Periodi di aggregazione supportati:

  • DAILY: le metriche vengono aggregate in intervalli di date di calendario. A causa di vincoli storici, l'unico fuso orario predefinito e supportato è America/Los_Angeles.
  • HOURLY: le metriche vengono aggregate in intervalli orari. Il fuso orario predefinito e solo supportato è UTC.
dimensions[]

string

Dimensioni in base a cui suddividere le metriche.

Dimensioni supportate:

  • apiLevel (string): il livello API di Android in esecuzione sul dispositivo dell'utente, ad esempio 26.
  • versionCode (int64): la versione dell'app in esecuzione sul dispositivo dell'utente.
  • deviceModel (string): identificatore univoco del modello di dispositivo dell'utente. L'identificatore è in formato "deviceBrand/device", dove deviceBrand corrisponde a Build.BRAND e device corrisponde a Build.DEVICE, ad esempio google/coral.
  • deviceBrand (string): identificatore univoco del brand del dispositivo dell'utente, ad esempio Google.
  • deviceType (string): il tipo (noto anche come fattore di forma) del dispositivo dell'utente, ad esempio TELEFONO.
  • countryCode (string): il paese o la regione del dispositivo dell'utente in base al suo indirizzo IP, rappresentato da un codice ISO-3166 a due lettere (ad es. US per gli Stati Uniti).
  • deviceRamBucket (int64): RAM del dispositivo, in MB, in bucket (3 GB, 4 GB e così via).
  • deviceSocMake (string): marca del system-on-chip principale del dispositivo, ad esempio Samsung. Riferimento
  • deviceSocModel (string): modello del system-on-chip principale del dispositivo, ad esempio "Exynos 2100". Riferimento
  • deviceCpuMake (string): marca della CPU del dispositivo, ad esempio Qualcomm.
  • deviceCpuModel (string): modello della CPU del dispositivo, ad esempio "Kryo 240".
  • deviceGpuMake (string): marca della GPU del dispositivo, ad esempio ARM.
  • deviceGpuModel (string): modello della GPU del dispositivo, ad esempio Mali.
  • deviceGpuVersion (string): versione della GPU del dispositivo, ad esempio T750.
  • deviceVulkanVersion (string): versione Vulkan del dispositivo, ad esempio "4198400".
  • deviceGlEsVersion (string): versione OpenGL ES del dispositivo, ad esempio "196610".
  • deviceScreenSize (string): le dimensioni dello schermo del dispositivo, ad esempio NORMALE, GRANDE.
  • deviceScreenDpi (string): densità schermo del dispositivo, ad esempio mdpi, hdpi.
metrics[]

string

Metriche da aggregare.

Metriche supportate:

  • crashRate (google.type.Decimal): percentuale di utenti distinti che nel periodo di aggregazione hanno riscontrato almeno un arresto anomalo.
  • crashRate7dUserWeighted (google.type.Decimal): valore medio mobile di crashRate negli ultimi 7 giorni. I valori giornalieri vengono ponderati in base al numero di utenti distinti per il giorno.
  • crashRate28dUserWeighted (google.type.Decimal): valore medio mobile di crashRate negli ultimi 28 giorni. I valori giornalieri vengono ponderati in base al numero di utenti distinti per il giorno. Non supportata con granularità ORARIA.
  • userPerceivedCrashRate (google.type.Decimal): percentuale di utenti distinti che nel periodo di aggregazione hanno riscontrato almeno un arresto anomalo mentre utilizzavano attivamente la tua app (arresto anomalo percepito dall'utente). Un'app è considerata in uso attivo se mostra attività o esegue un servizio in primo piano.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): valore medio mobile di userPerceivedCrashRate negli ultimi 7 giorni. I valori giornalieri vengono ponderati in base al numero di utenti distinti per il giorno. Non supportata con granularità ORARIA.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): valore medio mobile di userPerceivedCrashRate negli ultimi 28 giorni. I valori giornalieri vengono ponderati in base al numero di utenti distinti per il giorno. Non supportata con granularità ORARIA.
  • distinctUsers (google.type.Decimal): numero di utenti distinti nel periodo di aggregazione che sono stati utilizzati come valore di normalizzazione per le metriche crashRate e userPerceivedCrashRate. In questa metrica viene conteggiato un utente se ha utilizzato attivamente l'app durante il periodo di aggregazione. Un'app è considerata in uso attivo se mostra attività o esegue un servizio in primo piano. È necessario fare attenzione a non aggregare ulteriormente questo conteggio, in quanto gli utenti potrebbero essere conteggiati più volte. Il valore viene arrotondato al multiplo più vicino di 10, 100, 1000 o 1.000.000, a seconda dell'entità del valore.
filter

string

Filtri da applicare ai dati. L'espressione di filtro è conforme allo standard AIP-160 e supporta l'applicazione di filtri in base all'uguaglianza di tutte le dimensioni di analisi.

pageSize

integer

Dimensione massima dei dati restituiti.

Se il valore non è specificato, verranno restituite al massimo 1000 righe. Il valore massimo è 100.000; i valori superiori a 100.000 verranno costretti a 100.000.

pageToken

string

Un token di pagina, ricevuto da una chiamata precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token della pagina.

userCohort

enum (UserCohort)

Visualizzazione utente da selezionare. I dati di output corrisponderanno alla vista selezionata.

Valori supportati:

  • OS_PUBLIC Per selezionare dati da tutte le versioni di Android rilasciate pubblicamente. Questa è l'impostazione predefinita. Supporta tutte le dimensioni riportate sopra.
  • APP_TESTERS Per selezionare i dati degli utenti che hanno scelto di diventare tester. Supporta tutte le dimensioni riportate sopra.
  • OS_BETA Per selezionare dati soltanto dalle versioni beta di Android, esclusi i dati delle versioni Android rilasciate. Sono supportate solo le seguenti dimensioni:
  • versionCode (int64): la versione dell'app in esecuzione sul dispositivo dell'utente.

  • osBuild (string): build del sistema operativo del dispositivo dell'utente, ad esempio "T1B2.220916.004".

Corpo della risposta

Messaggio di risposta per crashrate.query.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Campi
rows[]

object (MetricsRow)

Righe di dati restituite.

nextPageToken

string

Token di continuazione per recuperare la pagina successiva di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.