Recuperar comentarios de apps

Algunas apps pueden enviar comentarios a EMM en forma de estados de apps con clave. Un estado de app con clave se compone de un identificador único (clave), un mensaje correspondiente (opcional), datos procesables (opcional), estado de gravedad y marca de tiempo. Para enviarlas, una app debe integrarse con 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 agregarán a la cola y se enviarán por completo cuando finalice el período. Por ejemplo, cuando se generan comentarios 3 veces a las [t=0s;10s;15s] con un período de enfriamiento de 1 minuto, los primeros comentarios se enviarán a las [t=0s] y los segundos a las [t=60s].

Como EMM, puedes usar los datos de los estados de app con clave para mantener actualizados a los administradores de TI con las apps instaladas en los perfiles y dispositivos administrados. En Mostrar 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 la app con clave por dispositivo. Los estados se incluyen en los informes de dispositivos. Para habilitar los informes de un dispositivo, haz lo siguiente:

  1. Sigue las instrucciones para 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. También puedes llamar al devices.get() para revisar el informe más reciente del dispositivo en cualquier momento.

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

Los informes de dispositivos están disponibles como recursos de dispositivos. Los estados de las apps con claves se agrupan por nombre de paquete en la sección informe de la aplicación, 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 contiene lo siguiente:

Campo Descripción
key La clave única que identifica el estado.
severity La gravedad del estado: INFO, que indica un mensaje informativo. Por ejemplo, si una configuración administrada se estableció 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 string opcional que proporciona detalles sobre el estado de la app. Se recomienda que los desarrolladores de apps consideren este campo como un mensaje para los usuarios.
data Es una string opcional que proporciona detalles legibles por computadora a los EMM sobre el estado de la app. Por ejemplo, un valor que pueda consultar un administrador de TI en su consola, como "notificarme si los datos de Battery_warning son inferiores a 10".
createTime 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 los 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 app con clave es proporcionar comentarios sobre la configuración administrada. Por ejemplo:

  1. Un administrador de TI usa tu consola de EMM para establecer la configuración administrada de una app.
  2. En el backend, usa ApplicationPolicy para enviar la configuración a la app.
  3. La app intenta aplicar las configuraciones. Para cada configuración, la app envía un estado de app con clave indicando 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 dispositivo.
  5. Con la información de los estados de app con clave, tu consola de EMM muestra el estado de las configuraciones administradas de una manera fácil de usar.

Alertar 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 de otros medios. Por ejemplo, tu consola de EMM podría mostrar un panel de errores que vincule a los comentarios de un dispositivo determinado con errores.

Si se corrige el 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 corrija un error. Por ejemplo, quita el error del panel de errores de la consola o márcalo como resuelto.