アプリによっては、キー付きのアプリの状態の形式で EMM にフィードバックを送信できます。鍵付きのアプリ状態は、一意の識別子(キー)、対応するメッセージ(省略可)、機械が読み取れるデータ(省略可)、重大度のステータス、タイムスタンプで構成されます。送信するには、アプリを Enterprise Jetpack ライブラリと統合する必要があります。
アプリが最初の即時フィードバックを送信できるのは、1 分に 1 回のみです。クールダウン期間中に生成されたフィードバックはキューに追加され、クールダウン期間の終了時にすべて送信されます。たとえば、[t=0s;10s;15s] の時点で 3 回フィードバックが生成され、クールダウン期間が 1 分の場合、最初の即時フィードバックは [t=0s] に、2 番目と 3 番目のフィードバックは [t=60s] に送信されます。
EMM は、鍵付きのアプリ状態のデータを使用して、管理対象デバイスとプロファイルにインストールされているアプリの最新情報を IT 管理者に提供できます。この仕組みの例については、企業にフィードバックを表示するをご覧ください。
デバイス レポートを有効にする
アプリは、キー付きのアプリの状態をデバイスごとに送信します。この状態はデバイス レポートに含まれます。デバイスのレポートを有効にするには:
- 手順に沿って企業向けの Pub/Sub 通知を設定します。ステップ 5 で、
enabledNotificationTypes
にSTATUS_REPORT
を含めます。 - デバイスごとにデバイス ポリシーを更新します(
StatusReportingSettings.applicationReportsEnabled
をtrue
に設定します)。
Pub/Sub API を使用してデバイス レポート通知を取得できるようになりました。devices.get()
を呼び出すと、デバイスの最新レポートをいつでも確認できます。
デバイス レポートでキー付きのアプリの状態を確認する
デバイス レポートは、デバイス リソースの形式で入手できます。キーが設定されたアプリの状態は、[アプリケーション レポート] セクションでパッケージ名ごとにグループ化されます。次に例を示します。
{
"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"
}
]
}
]
}
キー付きのアプリの状態には、それぞれ以下が含まれます。
項目 | 説明 |
---|---|
key |
状態を識別する一意のキー。 |
severity |
状態の重大度: INFO は、情報メッセージであることを示しています。(例: 管理対象の設定が正常に設定されている場合など)。ERROR は、問題を修正するために企業が対処する必要があることを示します。(管理対象設定の設定に失敗した場合など)。 |
message |
アプリの状態に関する詳細を示す文字列(省略可)。アプリ デベロッパーは、このフィールドをユーザー向けのメッセージとして扱うことをおすすめします。 |
data |
アプリの状態についてコンピュータで読み取り可能な詳細情報を EMM に提供する、省略可能な文字列。たとえば、IT 管理者がコンソールでクエリできる値(「Battery_warning データが 10 未満の場合は通知する」など)。 |
createTime |
デバイス上でアプリの状態がいつ作成されたかを示すタイムスタンプ。 |
lastUpdateTime |
アプリの状態がデバイス上で最後に更新された日時を示すタイムスタンプ。 |
企業にアプリのフィードバックを表示する
アプリはさまざまな理由でフィードバックを送信できます。ただし、キー付きのアプリの状態を送信する最も一般的なユースケースは、管理対象構成に関するフィードバックを提供することです。例:
- IT 管理者は EMM コンソールを使用して、アプリの管理対象設定を行います。
- バックエンドでは、ApplicationPolicy を使用してアプリに構成を送信します。
- アプリが構成の適用を試みます。アプリは、設定ごとに、ステータスを示すキー付きのアプリ状態(確認メッセージやエラー通知など)を送信します。
- このようなキー付きのアプリの状態を確認するには、デバイス レポートを取得します。
- EMM コンソールには、鍵付きのアプリ状態の情報を使用して、管理対象設定のステータスがユーザー フレンドリーな方法で表示されます。
IT 管理者にエラーを通知する
重大度が ERROR
の鍵付きアプリの状態は、問題を修正するために組織が対処する必要があることを示します。EMM は、EMM コンソールまたはその他の手段を通じて、常に組織にエラーを警告する必要があります。たとえば、EMM コンソールに、エラーのある特定のデバイスのフィードバックにリンクするエラー ダッシュボードを表示できます。
エラー状態が修正されると、アプリは元のエラー状態と同じキーと、更新された重大度 INFO
のフォローアップ状態を送信します。EMM はエラーが修正されたらすぐに常に組織に通知する必要があります。たとえば、コンソールのエラー ダッシュボードからエラーを削除するか、解決済みとしてマークします。