Recuperare feedback dalle app

Alcune app sono in grado di inviare feedback ai provider EMM sotto forma di stati delle app con chiave. Uno stato dell'app con chiave è composto da un identificatore univoco (chiave), un messaggio corrispondente (facoltativo), dati leggibili dalla macchina (facoltativo), uno stato di gravità e un timestamp. Per inviarli, un'app deve essere integrata con la libreria Jetpack Enterprise.

Un'app può inviare il primo feedback immediato una volta al minuto. I feedback generati durante il periodo di attesa verranno messi in coda e inviati del tutto al termine del periodo di attesa. 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].

In qualità di EMM, puoi utilizzare i dati degli stati delle app associati per tenere aggiornati gli amministratori IT con le app installate sui profili e sui dispositivi gestiti. Un esempio di come potrebbe funzionare è descritto in Mostrare feedback alle aziende.

Attivare i report sui dispositivi

Le app inviano gli stati delle app associati in base al dispositivo. 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 ogni dispositivo, aggiorna il criterio relativo ai dispositivi: imposta StatusReportingSettings.applicationReportsEnabled su true.

Ora puoi utilizzare l'API Pub/Sub per ricevere notifiche sui rapporti sui dispositivi. In alternativa, chiama il numero devices.get() per consultare in qualsiasi momento il report più recente di un dispositivo.

Visualizzare gli stati delle app associate nei report sui dispositivi

I report sui dispositivi sono disponibili sotto forma di risorse dispositivo. Gli stati delle app con chiave vengono raggruppati per nome del pacchetto nella sezione Report dell'applicazione, 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 una configurazione gestita è stata impostata correttamente. ERROR indica che l'azienda deve intervenire per risolvere un problema. ad esempio se non è stato possibile impostare una configurazione gestita.
message Una stringa facoltativa che fornisce dettagli sullo stato dell'app. Consigliamo agli sviluppatori di app di trattare questo campo come un messaggio rivolto agli utenti.
data Una stringa facoltativa che fornisce dettagli leggibili dal computer alle soluzioni EMM relative allo stato dell'app. Ad esempio, un valore su cui un amministratore IT potrebbe eseguire query nella tua console, come "avvisami se i dati della batteria_avviso sono < 10".
createTime Il timestamp che indica quando è stato creato lo stato dell'app sul dispositivo.
lastUpdateTime Timestamp che indica l'ultimo aggiornamento dello stato dell'app sul dispositivo.

Mostra il feedback delle app alle aziende

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

  1. Un amministratore IT utilizza la tua console EMM per impostare le configurazioni gestite per un'app.
  2. Nel backend, utilizza 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 questi stati dell'app associati alla chiave, devi recuperare un report sul dispositivo.
  5. La console EMM utilizza le informazioni degli stati dell'app in base alla chiave per mostrare lo stato delle configurazioni gestite in modo intuitivo.

Avvisare gli amministratori IT di errori

Uno stato dell'app associato a una chiave con gravità ERROR indica che l'organizzazione deve intervenire per correggere un problema. I provider EMM devono sempre avvisare le organizzazioni in caso di errori, tramite la console EMM o altri mezzi. Ad esempio, la console EMM potrebbe mostrare una dashboard degli errori che rimanda al feedback per 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 una gravità aggiornata di 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.