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 è costituito da un identificatore univoco (chiave), un messaggio corrispondente (facoltativo), dati leggibili dalla macchina (facoltativo), lo stato della gravità e il timestamp. Per inviarle, un'app deve essere integrata con la libreria Jetpack Enterprise.

In qualità di EMM, puoi utilizzare i dati degli stati delle app con chiave 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.

Attiva i report sui dispositivi

Le app inviano gli stati chiave delle app in base al dispositivo. Prima che gli stati delle app con chiave siano accettati da qualsiasi app sul dispositivo, devi attivare i report sul dispositivo. Finché il criterio non viene aggiornato sul dispositivo, tutti gli stati delle app associate vengono ignorati e persi definitivamente. Abilita i report sui dispositivi prima di completare la registrazione dei dispositivi il prima possibile durante il processo di registrazione. In questo modo riceverai il feedback sull'app generato durante la registrazione del dispositivo e che non perderai alcun stato dell'app chiave.

• Chiama il numero devices.update(), impostando policy.deviceReportPolicy su "deviceReportEnabled".

Recupero dei report sui dispositivi

Esistono diversi modi per recuperare una segnalazione sul dispositivo:

• Per recuperare i report sui dispositivi insieme ad altre notifiche, chiama il numero enterprises.pullNotificationSet(). Nella risposta, ogni deviceReportUpdateEvent indica una segnalazione sul dispositivo.
• Per recuperare un report sui dispositivi aggiornato con gli ultimi stati dell'app con chiave per un dispositivo specificato, chiama devices.get().
• Per forzare un dispositivo a caricare gli ultimi stati dell'app, chiama devices.forceReportUpload(). Questo metodo consente di caricare un report contenente eventuali modifiche degli stati dell'app sul dispositivo da quando è stato generato l'ultimo report.

Nota: puoi chiamare il numero devices.forceReportUpload() fino a tre volte ogni 24 ore per un determinato dispositivo. In genere, il dispositivo carica il feedback dell'app almeno una volta al giorno. La chiamata a devices.forceReportUpload() attiva il caricamento del feedback dell'app sul dispositivo il prima possibile. Il dispositivo richiede la connettività per garantire la tempestiva consegna del feedback dell'app. Tieni presente che il metodo richiede tempo, dati e batteria del dispositivo. Pertanto, limita l'utilizzo di questo metodo alle azioni non frequenti che richiedono l'invio tempestivo del feedback dell'app.

Visualizza gli stati delle app con chiavi

I report sui dispositivi fanno parte delle risorse dei dispositivi. I report includono un oggetto appState per ogni app (pacchetto) installata sul dispositivo o nel relativo profilo di lavoro. Gli stati dell'app con chiave (keyedAppState) per un determinato pacchetto sono elencati nell'oggetto appState, come nell'esempio seguente:

{
   "result":{
      "kind":"androidenterprise#device",
      "report":{
         "appState":[
            {
               "keyedAppState":[
                  {
                     "severity":"severityError",
                     "data":"user",
                     "message":"Username or password are incorrect",
                     "key":"account",
                     "stateTimestampMillis":"1556206406926"
                  }
               ],
               "packageName":"com.google.android.feedbacktestapp"
            }
         ],
         "lastUpdatedTimestampMillis":"1556206407685"
      },
      "androidId":"32714368a0ad8ad5",
      "managementType":"managedProfile",
      "policy":{
         "deviceReportPolicy":"deviceReportEnabled"
      }
   }
}

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 viene 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 i 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 ai provider EMM dettagli leggibili dal computer relativi allo stato dell'app. Ad esempio, un valore su cui un amministratore IT potrebbe eseguire query nella console, come "avvisami se i dati di battery_warning sono inferiori a 10".
stateTimestampMillis	Il timestamp (in millisecondi) che indica l'ultimo aggiornamento dello stato dell'app sul dispositivo.
lastUpdatedTimestampMillis	Il timestamp (in millisecondi) che indica quando il dispositivo ha caricato l'ultimo stato dell'app chiave.

Mostrare alle aziende il feedback sulle app

Le app possono inviare feedback per diversi motivi. Tuttavia, il caso d'uso più comune per l'invio di 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 invii 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 chiave, devi recuperare un report sul dispositivo.
5. Utilizzando le informazioni degli stati delle app con chiave, la console EMM visualizza lo stato delle configurazioni gestite in modo facile da usare.

Avvisa gli amministratori IT in caso di errori

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

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

Suggerimento: aggiungi il supporto per gli amministratori IT per disattivare un errore specifico nel caso in cui un'app non riesca ad aggiornare correttamente uno stato di errore dopo la risoluzione dell'errore.