Recuperare feedback dalle app

Alcune app possono inviare feedback agli EMM sotto forma di stati delle app con chiave. Uno stato dell'app con chiave è costituito da un identificatore univoco (chiave), da un messaggio corrispondente (facoltativo), da dati leggibili leggibili dal computer (facoltativi), da stato di gravità e timestamp. Per inviarle, un'app deve essere integrata con la libreria Enterprise Jetpack.

Un'app può inviare il primo feedback immediato solo una volta al minuto. I feedback generati durante il periodo di attesa verranno messi in coda e inviati interamente al termine di questo periodo. Ad esempio, quando il feedback viene generato 3 volte a [t=0s;10s;15s] con un periodo di attesa di 1 minuto: il primo feedback immediato verrà inviato a [t=0s], il secondo e il terzo feedback a [t=60s].

Come EMM, puoi utilizzare i dati degli stati delle app con chiave per mantenere aggiornati gli amministratori IT con le app installate sui profili e sui dispositivi gestiti. Un esempio di come potrebbe funzionare è descritto in Visualizzare il feedback alle aziende.

Attiva i report sui dispositivi

Le app inviano gli stati delle app con chiave per singoli dispositivi. Gli stati sono inclusi nei report sui dispositivi. Per attivare i report per un dispositivo:

  1. Segui le istruzioni per la configurazione delle notifiche Pub/Sub per un'azienda. Nel Passaggio 5, includi STATUS_REPORT in enabledNotificationTypes.
  2. Per ciascun dispositivo, aggiorna il criterio relativo ai dispositivi: imposta StatusReportingSettings.applicationReportsEnabled su true.

Ora puoi utilizzare l'API Pub/Sub per ricevere notifiche relative ai report del dispositivo. In alternativa, puoi consultare in qualsiasi momento l'ultimo report di un dispositivo: chiama il numero devices.get().

Visualizzare gli stati delle app con chiave nei report dei dispositivi

I report sui dispositivi sono disponibili sotto forma di risorse dei dispositivi. Gli stati delle app con chiavi vengono raggruppati per nome del pacchetto nella sezione Report sulle applicazioni, come mostrato nell'esempio seguente:

{
   "applicationReports":[
      {
         "packageName": "pkg1",
         "versionCode": 101,
         "keyedAppStates":[
            {
               "key": "key1",
               "severity": INFO,
               "message": "message1",
               "data": "data1",
               "createTime": "2018-10-01T15:01:22.027623745Z",
               "lastUpdateTime": "2018-10-02T15:01:23.045123456Z"
            }
         ]
      }
   ]
}

Ogni stato dell'app con chiave contiene quanto segue:

Campo Descrizione
key La chiave univoca che identifica lo stato.
severity La gravità dello stato: INFO indica un messaggio informativo. ad esempio se l'impostazione di una configurazione gestita è andata a buon fine. ERROR indica che l'azienda deve intervenire per risolvere un problema. ad esempio se l'impostazione di una configurazione gestita non è riuscita.
message Una stringa facoltativa che fornisce dettagli sullo stato dell'app. Consigliamo agli sviluppatori di app di considerare questo campo come un messaggio rivolto agli utenti.
data Una stringa facoltativa che fornisce ai provider EMM dettagli leggibili dal computer sullo stato dell'app. Ad esempio, un valore in base al quale un amministratore IT potrebbe eseguire query nella console, come "avvisami se i dati avvisi_batteria < 10".
createTime Il timestamp che indica quando è stato creato lo stato dell'app sul dispositivo.
lastUpdateTime Timestamp che indica la data dell'ultimo aggiornamento dello stato dell'app sul dispositivo.

Mostra feedback sull'app alle aziende

Le app possono inviare feedback per diversi motivi. Tuttavia, il caso d'uso più comune per l'invio degli stati delle app con chiave è fornire un feedback sulle configurazioni gestite. Ad esempio:

  1. Un amministratore IT utilizza la console EMM per impostare le configurazioni gestite di un'app.
  2. Nel backend, utilizzi ApplicationPolicy per inviare le configurazioni all'app.
  3. L'app tenta di applicare le configurazioni. Per ogni configurazione, l'app invia uno stato dell'app con chiave che ne indica lo stato (ad esempio, un messaggio di conferma o una notifica di errore).
  4. Per visualizzare gli stati dell'app con chiave, recupera un report sul dispositivo.
  5. Utilizzando le informazioni relative agli stati delle app con chiave, la console EMM mostra lo stato delle configurazioni gestite in modo intuitivo.

Avvisare gli amministratori IT in caso di errori

Uno stato dell'app con chiave con gravità ERROR indica che l'organizzazione deve intervenire per correggere un problema. I EMM devono sempre avvisare le organizzazioni in caso di errori, tramite la loro console EMM o altri mezzi. Ad esempio, nella console EMM potrebbe essere visualizzata una dashboard degli errori che rimanda al feedback relativo a un determinato dispositivo con errori.

Se uno stato di errore viene corretto, l'app invierà uno stato di follow-up con la stessa chiave dello stato di errore originale e con una gravità aggiornata pari a INFO. I provider EMM devono sempre informare le organizzazioni non appena viene corretto un errore. Ad esempio, rimuovi l'errore dalla dashboard degli errori della console o contrassegnalo come risolto.