Recuperar feedback de apps

Alguns apps podem enviar feedback para EMMs na forma de app com chave estados. O estado de um app com chave é composto por um identificador exclusivo (chave), mensagem correspondente (opcional), dados legíveis por máquina (opcional), gravidade status e carimbo de data/hora. Para enviá-las, um app precisa se integrar ao Biblioteca Enterprise Jetpack.

Um app só pode enviar o primeiro feedback imediato uma vez por minuto. O feedback gerado durante o período de espera será colocado na fila e enviado completamente quando o período de espera terminar. Por exemplo, quando o feedback é gerado três vezes em [t=0s;10s;15s] com um período de espera de um minuto: o primeiro feedback imediato é enviado em [t=0s], o segundo e o terceiro em [t=60s].

Como EMM, você pode usar os dados de estados de apps codificados para manter os administradores de TI atualizados com os apps instalados nos dispositivos e perfis gerenciados. Um exemplo de como isso pode funcionar é descrito em Exibir feedback para de empresas.

Ativar relatórios do dispositivo

Os apps enviam estados com chaves por dispositivo. Os estados estão incluídos em relatórios do dispositivo. Para ativar os relatórios em um dispositivo:

  1. Siga as instruções para configurar as notificações do Pub/Sub. para uma empresa. Na Etapa 5, incluir STATUS_REPORT em enabledNotificationTypes.
  2. Atualize a política de cada dispositivo: definida StatusReportingSettings.applicationReportsEnabled para true.

Agora é possível usar a API Pub/Sub para receber notificações de relatórios do dispositivo. Ou, para analisar o relatório mais recente de um dispositivo a qualquer momento, chame devices.get().

Conferir estados do app com chave nos relatórios do dispositivo

Os relatórios de dispositivos estão disponíveis como recursos do dispositivo. Os estados do app codificados são agrupados por nome de pacote na seção Relatório de aplicativos, conforme mostrado no exemplo abaixo:

{
   "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"
            }
         ]
      }
   ]
}

Cada estado do app inserido contém o seguinte:

Campo Descrição
key A chave exclusiva que identifica o estado.
severity A gravidade do estado INFO indica uma mensagem informativa. Por exemplo, se uma configuração gerenciada foi definida. ERROR indica que a empresa precisa entrar em ação para corrigir um problema. Por exemplo, se uma configuração gerenciada não foi definida.
message Uma string opcional que fornece detalhes sobre o estado do app. Recomendamos que os desenvolvedores de apps tratem esse campo como uma mensagem voltada ao usuário.
data Uma string opcional que fornece detalhes legíveis por computador aos EMMs sobre o estado do app. Por exemplo, um valor que um administrador de TI possa consultar no console, como "notificar-me se os dados de aviso_bateria < 10".
createTime Carimbo de data/hora que indica quando o estado do app foi criado no dispositivo.
lastUpdateTime Carimbo de data/hora que indica quando o estado do app foi atualizado pela última vez no dispositivo.

Exibir feedback do app para as empresas

Os apps podem enviar feedback por vários motivos. No entanto, o uso mais comum caso de envio de estados com chave de app é enviar feedback sobre personalizadas. Exemplo:

  1. Um administrador de TI usa o console de EMM para definir configurações gerenciadas de um app.
  2. No back-end, use ApplicationPolicy para enviar as configurações ao app.
  3. O app tenta aplicar as configurações. Para cada configuração, o app envia um estado de app com chave indicando seu status (por exemplo, uma solicitação ou notificação de erro).
  4. Para conferir esses estados do app codificados, extraia um relatório do dispositivo.
  5. Usando informações dos estados do app criptografado, o console de EMM exibe as o status das configurações gerenciadas de maneira fácil de usar.

Alertar os administradores de TI sobre erros

Um estado do app com chave e gravidade ERROR indica que a organização precisa para corrigir um problema. Os EMMs sempre devem alertar as organizações a erros, seja pelo console de EMM ou por outros meios. Por exemplo, seu o console de EMM pode exibir um painel de erros vinculado ao feedback de uma dispositivo com erros.

Se um estado de erro for corrigido, o app enviará um estado de acompanhamento com o mesma chave que o estado de erro original e uma gravidade atualizada de INFO. EMM sempre devem informar as organizações assim que um erro for corrigido. Para exemplo, remova o erro do painel de erros de seu console ou marque-o como resolvido.