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