Method: vitals.excessivewakeuprate.query

Esegue una query sulle metriche nel set di metriche.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa.

Formato: apps/{app}/excessiveWakeupRateMetricSet

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)

Facoltativo. 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 supportato è America/Los_Angeles.
dimensions[]

string

Facoltativo. Dimensioni in base alle quali segmentare i dati.

Dimensioni supportate:

  • apiLevel (string): il livello API di Android in esecuzione sul dispositivo dell'utente, ad es. 26.
  • versionCode (int64): versione dell'app in esecuzione sul dispositivo dell'utente.
  • deviceModel (string): identificatore univoco del modello del dispositivo dell'utente. Il formato dell'identificatore è "deviceBrand/device", dove deviceBrand corrisponde a Build.BRAND e device corrisponde a Build.DEVICE, ad es. 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 es. PHONE.
  • countryCode (string): il paese o la regione del dispositivo dell'utente in base al suo indirizzo IP, rappresentato come un codice ISO-3166 a 2 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 es. "Exynos 2100". Riferimento
  • deviceCpuMake (string): marca della CPU del dispositivo, ad es. Qualcomm.
  • deviceCpuModel (string): modello della CPU del dispositivo, ad es. "Kryo 240".
  • deviceGpuMake (string): marca della GPU del dispositivo, ad es. ARM.
  • deviceGpuModel (string): modello della GPU del dispositivo, ad es. 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 es. NORMAL, LARGE.
  • deviceScreenDpi (string): densità dello schermo del dispositivo, ad es. mdpi, hdpi.
metrics[]

string

Facoltativo. Metriche da aggregare.

Metriche supportate:

  • 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): valore medio mobile di excessiveWakeupRate negli ultimi 7 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno.
  • excessiveWakeupRate28dUserWeighted (google.type.Decimal): valore medio mobile di excessiveWakeupRate negli ultimi 28 giorni. I valori giornalieri sono ponderati in base al conteggio degli utenti distinti per il giorno.
  • distinctUsers (google.type.Decimal): conteggio degli utenti distinti nel periodo di aggregazione che sono stati utilizzati come valore di normalizzazione per la metrica excessiveWakeupRate. Un utente viene conteggiato in questa metrica se la sua app ha eseguito qualsiasi operazione sul dispositivo, ovvero non solo l'utilizzo attivo in primo piano, ma anche il lavoro in background. È 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 entità.
filter

string

Facoltativo. Filtri da applicare ai dati. L'espressione di filtro segue lo standard AIP-160 e supporta il filtraggio in base all'uguaglianza di tutte le dimensioni di suddivisione.
pageSize

integer

Facoltativo. Dimensione massima dei dati restituiti.

Se non viene 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

Facoltativo. Un token di pagina, ricevuto da una chiamata precedente. Forniscilo per recuperare la pagina successiva.

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

enum (UserCohort)

Facoltativo. Visualizzazione utente da selezionare. I dati di output corrisponderanno alla visualizzazione selezionata. L'unico valore supportato è OS_PUBLIC.

Corpo della risposta

Messaggio di risposta per excessivewakeuprate.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 saperne di più, consulta la OAuth 2.0 Overview.