Recuperar feedback de apps

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

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

Ativar relatórios do dispositivo

Os apps enviam estados de app com chave por dispositivo. Antes que qualquer estado de app vinculado seja aceito em qualquer um dos apps no dispositivo, é necessário ativar os relatórios para um dispositivo. Até que a política seja atualizada no dispositivo, todos os estados de apps codificados serão ignorados e perdidos para sempre. Ative os relatórios de dispositivos antes de concluir o registro do dispositivo, o mais cedo possível no processo de inscrição. Isso garante que você receba feedback do app gerado durante o registro do dispositivo e que nenhum estado de app com chave seja perdido.

  • Chame devices.update(), definindo policy.deviceReportPolicy como "deviceReportEnabled".

Recuperar relatórios do dispositivo

Há várias maneiras de recuperar um relatório de dispositivos:

  • Para acessar relatórios do dispositivo com outras notificações, chame enterprises.pullNotificationSet(). Na resposta, cada deviceReportUpdateEvent indica um relatório de dispositivo.
  • Para recuperar um relatório de dispositivo atualizado com os estados mais recentes do app com chave para um dispositivo especificado, chame devices.get().
  • Para forçar um dispositivo a fazer upload dos estados mais recentes do app, chame devices.forceReportUpload(). Esse método faz upload de um relatório que contém todas as mudanças nos estados do app no dispositivo desde que o último relatório foi gerado.

Ver estados de apps com chave

Os relatórios de dispositivos fazem parte dos recursos do dispositivo. Os relatórios incluem um objeto appState para cada app (pacote) instalado no dispositivo ou no perfil de trabalho. Os estados do app chave (keyedAppState) para um determinado pacote são listados no objeto appState, como no exemplo abaixo:

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

Cada estado com chave 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 for definida. ERROR indica que a empresa precisa tomar medidas para corrigir um problema. Por exemplo, se uma configuração gerenciada não for definida.
message 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 seu console, como "notificar-me se os dados da bateria_warning forem < 10".
stateTimestampMillis O carimbo de data/hora (em milissegundos) que indica quando o estado do app foi atualizado pela última vez no dispositivo.
lastUpdatedTimestampMillis O carimbo de data/hora (em milissegundos) que indica quando o dispositivo fez upload dos últimos estados de app com chave.

Mostre feedback sobre o app para empresas

Os apps podem enviar feedback por vários motivos. No entanto, o caso de uso mais comum para enviar estados de app com chave é enviar feedback sobre configurações gerenciadas. Exemplo:

  1. Um administrador de TI usa o console de EMM para definir configurações gerenciadas para um app.
  2. No back-end, você envia as configurações ao app.
  3. O app tenta aplicar as configurações. Para cada configuração, o app envia um estado com chave indicando o status. Por exemplo, uma mensagem de confirmação ou notificação de erro.
  4. Para conferir esses estados de apps com chave, recupere um relatório de dispositivos.
  5. Usando informações dos estados de apps com chaves, o console de EMM mostra o status das configurações gerenciadas de maneira fácil de usar.

Alertar os administradores de TI sobre erros

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

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