Alcune app sono in grado di inviare feedback ai provider EMM sotto forma di app con chiave stati. Uno stato dell'app con chiave è costituito da un identificatore univoco (chiave), messaggio corrispondente (facoltativo), dati leggibili dalla macchina (facoltativo), gravità lo stato attuale e il timestamp. Per inviarli, un'app deve integrarsi con Libreria Enterprise Jetpack.
In qualità di EMM, puoi utilizzare i dati provenienti dagli stati delle app con chiave per mantenere gli amministratori IT. con le app installate sui dispositivi e sui profili gestiti. Esempio di come funziona questa procedura è descritto nell'articolo Mostrare il feedback alle aziende.
Attiva i report sui dispositivi
Le app inviano gli stati con chiavi in base al dispositivo. Prima di qualsiasi stato dell'app con chiave sono accettati da una qualsiasi delle app presenti sul dispositivo, devi attivare il dispositivo report per un dispositivo. Fino a quando il criterio non viene aggiornato sul dispositivo, tutte le app con chiave vengono ignorati e persi definitivamente. Attiva i report sui dispositivi prima completare la registrazione dei dispositivi, il prima possibile durante la registrazione e il processo di sviluppo. In questo modo ti assicuri di ricevere feedback sull'app generati durante il dispositivo registrazione e che gli stati dell'app con chiave non vadano persi.
- Chiama il numero
devices.update()
, impostazionepolicy.deviceReportPolicy
su"deviceReportEnabled"
.
Recuperare i report sui dispositivi
Esistono diversi modi per recuperare un report sul dispositivo:
- Per recuperare i report sui dispositivi insieme ad altre notifiche, chiama
enterprises.pullNotificationSet()
Nella risposta, ognideviceReportUpdateEvent
indica la segnalazione di un dispositivo. - Per recuperare un report dispositivo aggiornato con gli ultimi stati delle app con chiave per un
dispositivo specificato, chiama
devices.get()
. - Per forzare il caricamento degli ultimi stati dell'app su un dispositivo, chiama
devices.forceReportUpload()
Questo metodo carica un report contenente eventuali modifiche agli stati dell'app nella dispositivo da quando è stato generato l'ultimo report.
Visualizza stati delle app con chiave
I report sui dispositivi fanno parte delle risorse dei dispositivi. I report includono un 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 in
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 è 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 considerare questo campo come un messaggio rivolto agli utenti. |
data |
Una stringa facoltativa che fornisce agli EMM dettagli leggibili dal computer sullo stato dell'app. Ad esempio, un valore su cui un amministratore IT può eseguire una query nella tua console, come "Avvisami se i dati della batteria_warning < 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 con chiave. |
Mostra il feedback sulle app alle aziende
Le app possono inviare feedback per diversi motivi. Tuttavia, l'uso più comune l'invio di stati delle app con chiavi è fornire feedback sugli configurazioni. Ad esempio:
- Un amministratore IT utilizza la tua console EMM per impostare le configurazioni gestite di un'app.
- Nel backend, invii le configurazioni all'app.
- L'app tenta di applicare le configurazioni. Per ogni configurazione, invia uno stato dell'app con chiave che ne indica lo stato (ad esempio, una conferma un messaggio di errore o una notifica di errore).
- Per visualizzare questi stati delle app con chiave, recupera un report sul dispositivo.
- Utilizzando le informazioni provenienti dagli stati delle app con chiave, la console EMM visualizza delle configurazioni gestite in modo intuitivo.
Avvisa gli amministratori IT di errori
Uno stato dell'app con chiave e gravità ERROR
indica che l'organizzazione deve eseguire
per correggere un problema. I provider EMM devono sempre avvisare le organizzazioni
agli 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
un determinato dispositivo con errori.
Se uno stato di errore viene corretto, l'app invia uno stato di follow-up con la stessa chiave
come stato di errore originale e con una gravità aggiornata pari a INFO
. I provider EMM devono
Informa sempre le organizzazioni non appena viene corretto un errore. Ad esempio:
rimuovi l'errore dalla dashboard degli errori della console o contrassegnalo come risolto.