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.

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 Enviar feedback para as empresas.

Ativar relatórios do dispositivo

Os apps enviam estados com chaves por dispositivo. Antes de qualquer estado do app com chave forem aceitos em qualquer um dos apps no dispositivo, será necessário ativá-lo para um dispositivo. Até que a política seja atualizada no dispositivo, todos os apps são ignorados e perdidos para sempre. Ativar relatórios do dispositivo antes concluir o registro do dispositivo o mais cedo possível de desenvolvimento de software. Isso garante que você receba feedback do app gerado durante registro e para 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 dispositivo:

  • Para recuperar relatórios do dispositivo junto 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 codificados para uma 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 envia um relatório com as mudanças nos estados do app na dispositivo desde que o último relatório foi gerado.
.

Conferir estados do app com chave

Os relatórios de dispositivos fazem parte dos recursos do dispositivo. Os relatórios incluem um appState para cada app (pacote) instalado no dispositivo ou no perfil de trabalho dele. Os estados do app com chave (keyedAppState) para um determinado pacote estão listados em 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 do app 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 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".
stateTimestampMillis 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 o estado do último app com chave enviado pelo 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 para um app.
  2. No back-end, envie as configurações para o 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 com chave, recupere 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 envia um estado de acompanhamento com a mesma chave como o estado de erro original e uma gravidade atualizada de INFO. EMMs devem sempre informam as organizações assim que um erro é corrigido. Por exemplo: remova o erro do painel de erros de seu console ou marque-o como resolvido.