Method: vitals.anrrate.query

Esegue query sulle metriche nel set di metriche.

Richiesta HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa.

Formato: apps/{app}/anrRateMetricSet

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 cronologia.

Periodi di aggregazione supportati:

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

string

Dimensioni in base alle quali 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. Il formato dell'identificatore è "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 es. google.
  • deviceType (string): il tipo (noto anche come fattore di forma) del dispositivo dell'utente, ad esempio PHONE.
  • countryCode (string): il paese o la regione del dispositivo dell'utente in base al suo indirizzo IP, rappresentato come codice ISO-3166 di 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 es. Samsung. Riferimento
  • deviceSocModel (string): modello del system-on-chip principale del dispositivo, ad esempio "Exynos 2100". Riferimento
  • deviceCpuMake (string): produttore della CPU del dispositivo, ad es. 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 es. T750.
  • deviceVulkanVersion (string): versione Vulkan del dispositivo, ad es. "4198400".
  • deviceGlEsVersion (string): versione OpenGL ES del dispositivo, ad es. "196610".
  • deviceScreenSize (string): dimensioni dello schermo del dispositivo, ad esempio NORMALE, GRANDE.
  • deviceScreenDpi (string): densità dello schermo del dispositivo, ad esempio mdpi, hdpi.
metrics[]

string

Metriche da aggregare.

Metriche supportate:

  • anrRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione che hanno riscontrato almeno un errore ANR.
  • anrRate7dUserWeighted (google.type.Decimal): valore della media mobile di anrRate negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno. Non supportata nella granularità ORARIA.
  • anrRate28dUserWeighted (google.type.Decimal): valore della media mobile di anrRate negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno. Non supportata nella granularità ORARIA.
  • userPerceivedAnrRate (google.type.Decimal): percentuale di utenti unici nel periodo di aggregazione che hanno riscontrato almeno un errore ANR percepito dall'utente. Attualmente, gli errori ANR percepiti dall'utente sono quelli di tipo "Invio input".
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal): valore medio mobile di userPerceivedAnrRate negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno. Non supportata nella granularità ORARIA.
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal): valore medio mobile di userPerceivedAnrRate negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti unici per il giorno. Non . supportato con granularità ORARIA.
  • distinctUsers (google.type.Decimal): conteggio degli utenti distinti nel periodo di aggregazione che sono stati utilizzati come valore di normalizzazione per le metriche anrRate e userPerceivedAnrRate. Un utente viene conteggiato in questa metrica se ha utilizzato l'app in primo piano durante il periodo di aggregazione. È necessario prestare attenzione a non aggregare ulteriormente questo conteggio, in quanto potrebbe comportare il conteggio degli utenti più volte. Il valore viene arrotondato al multiplo più vicino di 10, 100, 1000 o 1.000.000, a seconda della sua grandezza.
filter

string

Filtri da applicare ai dati. L'espressione di filtro segue lo standard AIP-160 e supporta il filtro per uguaglianza di tutte le dimensioni di distribuzione.

pageSize

integer

Dimensione massima dei dati restituiti.

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

pageToken

string

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

Durante la paginazione, tutti gli altri parametri forniti alla richiesta devono corrispondere alla chiamata che ha fornito il token di pagina.

userCohort

enum (UserCohort)

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

Valori supportati:

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

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

Corpo della risposta

Messaggio di risposta per anrrate.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 di dati successiva.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la OAuth 2.0 Overview.