Recuperar comentarios de apps

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

Una app solo puede enviar los primeros comentarios inmediatos una vez por minuto. Los comentarios generados durante el período de inactividad se pondrán en cola y se enviarán por completo cuando finalice el período. Por ejemplo, cuando los comentarios se generan 3 veces en [t=0s;10s;15s] con un período de inactividad de 1 minuto, el primer comentario inmediato se enviará a [t=0s], el segundo y el tercero se enviará a [t=60s].

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

Habilitar los informes del dispositivo

Las apps envían estados de app con clave por dispositivo. Los estados se incluyen en los informes de dispositivos. Para habilitar los informes en un dispositivo, sigue estos pasos:

  1. Sigue las instrucciones a fin de configurar las notificaciones de Pub/Sub para una empresa. En el Paso 5, incluye STATUS_REPORT en enabledNotificationTypes.
  2. Para cada dispositivo, actualiza la política de dispositivo: establece StatusReportingSettings.applicationReportsEnabled en true.

Ahora puedes usar la API de Pub/Sub para recibir notificaciones de informes de dispositivos. O bien, para revisar el informe más reciente de un dispositivo en cualquier momento, llama al devices.get().

Visualiza los estados de las apps con clave en los informes de dispositivos

Los informes de dispositivos están disponibles en forma de recursos de dispositivos. Los estados de la app con clave se agrupan por nombre de paquete en la sección Informe de apps, como se muestra en el siguiente ejemplo:

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

Campo Descripción
key Es la clave única que identifica el estado.
severity La gravedad del estado: INFO indica un mensaje informativo. Por ejemplo, si se estableció correctamente una configuración administrada. ERROR indica que la empresa debe tomar medidas para corregir un problema. Por ejemplo, si no se pudo establecer una configuración administrada.
message Es 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 los EMM sobre el estado de la app. Por ejemplo, un valor que un administrador de TI podría consultar en tu consola, como “notificarme si los datos de Battery_warning son inferiores a 10”.
createTime Es la marca de tiempo que indica cuándo se creó el estado de la app en el dispositivo.
lastUpdateTime Marca de tiempo que indica cuándo se actualizó por última vez el estado de la app en el dispositivo.

Muestra comentarios sobre la app a las empresas

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

  1. Un administrador de TI usa tu consola de EMM para establecer configuraciones administradas para una app.
  2. En el backend, usas ApplicationPolicy para enviar los parámetros de configuración a la app.
  3. La app intenta aplicar los parámetros de configuración. 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 app con clave, debes recuperar 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.

Alerta a los administradores de TI sobre 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 errores, ya sea a través de su consola de EMM o por otros medios. Por ejemplo, tu consola de EMM podría mostrar un panel de errores con un vínculo a los comentarios sobre un dispositivo determinado con errores.

Si se corrige un estado de error, la app enviará 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 la consola o márcalo como resuelto.