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:
- Segui le istruzioni per la configurazione delle notifiche Pub/Sub per un'azienda. Nel Passaggio 5, includi
STATUS_REPORT
inenabledNotificationTypes
. - Per ogni dispositivo, aggiorna il criterio relativo ai dispositivi: imposta
StatusReportingSettings.applicationReportsEnabled
sutrue
.
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:
- Un amministratore IT utilizza la tua console EMM per impostare le configurazioni gestite per un'app.
- Nel backend, utilizza ApplicationPolicy per inviare le configurazioni all'app.
- 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).
- Per visualizzare questi stati dell'app associati alla chiave, devi recuperare un report sul dispositivo.
- 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.