Recuperar comentarios de apps

Algunas apps son capaces de enviar comentarios a EMM en forma de estados de apps con clave. El estado de la app con clave consta de un identificador único (clave), el mensaje correspondiente (opcional), datos legibles por máquina (opcional), un estado de gravedad y una marca de tiempo. Para enviarlos, la app debe integrarse en la biblioteca de Enterprise Jetpack.

Como EMM, puedes usar los datos de los estados de la app con clave para mantener a los administradores de TI actualizados con las apps instaladas en los dispositivos y perfiles administrados. En el artículo Cómo mostrar comentarios a las empresas, se describe un ejemplo de cómo podría funcionar.

Habilitar los informes de dispositivos

Las apps envían estados de app con clave por dispositivo. Antes de que se acepten los estados de la app con clave de cualquiera de las apps del dispositivo, debes habilitar los informes del dispositivo para un dispositivo. Hasta que se actualice la política en el dispositivo, los estados de la app con clave se ignorarán y se perderán para siempre. Habilita los informes de dispositivos antes de completar la inscripción del dispositivo, lo antes posible en el proceso de inscripción. Esto garantiza que recibas los comentarios sobre la app generados durante la inscripción del dispositivo y que no se pierdan los estados de la app con clave.

  • Llama a devices.update() y establece policy.deviceReportPolicy en "deviceReportEnabled".

Recupera informes de dispositivos

Existen varias formas de recuperar un informe de dispositivos:

  • Para recuperar informes del dispositivo y otras notificaciones, llama a enterprises.pullNotificationSet(). En la respuesta, cada deviceReportUpdateEvent denota un informe de dispositivo.
  • Para recuperar un informe de dispositivo actualizado con los últimos estados de la app con clave para un dispositivo especificado, llama a devices.get().
  • Para forzar que un dispositivo suba los estados más recientes de la app, llama a devices.forceReportUpload(). Este método sube un informe que contiene los cambios en los estados de la app en el dispositivo desde que se generó el último informe.

Cómo ver estados de apps con clave

Los informes de dispositivos forman parte de los recursos del dispositivo. Los informes incluyen un objeto appState por cada app (paquete) instalada en el dispositivo o en su perfil de trabajo. Los estados de la app con clave (keyedAppState) para un paquete determinado se enumeran en el objeto appState, como en el siguiente ejemplo:

{
   "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 de app con clave contiene lo siguiente:

Campo Descripción
key La clave única que identifica el estado.
severity La gravedad del estado: INFO indica que se trata de un mensaje informativo. Por ejemplo, si una configuración administrada se establece correctamente. ERROR indica que la empresa debe tomar medidas para corregir un problema. Por ejemplo, si no se pudo establecer una configuración administrada.
message Una cadena opcional que proporciona detalles sobre el estado de la app. Se recomienda a los desarrolladores de apps que traten este campo como un mensaje para el usuario.
data Es una cadena opcional que proporciona detalles legibles por computadora a EMM sobre el estado de la app. Por ejemplo, un valor que un administrador de TI podría consultar en la consola, como "notificarme si los datos de Battery_warning < 10".
stateTimestampMillis Es la marca de tiempo (en milisegundos) que indica cuándo se actualizó por última vez el estado de la app en el dispositivo.
lastUpdatedTimestampMillis Es la marca de tiempo (en milisegundos) que indica cuándo el dispositivo subió el estado de la app con clave por última vez.

Muestra comentarios sobre la app a las empresas

Las apps pueden enviar comentarios por varios motivos. Sin embargo, el caso de uso más común para enviar estados de apps con clave es proporcionar comentarios sobre las configuraciones administradas. Por ejemplo:

  1. Un administrador de TI usa tu consola de EMM para establecer parámetros de configuración administrados para una app.
  2. En el backend, envías las configuraciones a la app.
  3. La app intenta aplicar las configuraciones. Para cada configuración, la app envía un estado de app con clave que indica su estado (por ejemplo, un mensaje de confirmación o una notificación de error).
  4. Para ver estos estados de apps con clave, recupera un informe de dispositivos.
  5. Con la información de los estados de la app con clave, tu consola de EMM muestra el estado de las configuraciones administradas de una manera fácil de usar.

Avisa a los administradores de TI sobre los errores

Un estado de app con clave con gravedad ERROR indica que la organización debe tomar medidas para corregir un problema. Los EMM siempre deben alertar a las organizaciones sobre los errores, ya sea a través de su consola de EMM o por otros medios. Por ejemplo, la consola de EMM podría mostrar un panel de errores con un vínculo a los comentarios de un dispositivo determinado con errores.

Si se corrige un estado de error, la app envía un estado de seguimiento con la misma clave que el estado de error original y una gravedad actualizada de INFO. Los EMM siempre deben informar a las organizaciones en cuanto se corrige un error. Por ejemplo, quita el error del panel de errores de tu consola o márcalo como resuelto.