通話終了アンケート
Note
通話終了調査は現在、Web SDK (JavaScript) でのみサポートしています。
前提条件
Azure Communication Services では、Azure Monitor ログの概要と Azure Monitor メトリックを介して、監視と分析の機能を提供しています。 各 Azure リソースには、次の条件を定義する独自の診断設定が必要です。
- 設定で定義されている送信先に送信されるログとメトリック データのカテゴリ。 使用できるカテゴリは、リソースの種類によって異なります。
- ログを送信する 1 つ以上の送信先。 現在の送信先には、Log Analytics ワークスペース、Event Hubs、Azure Storage が含まれます。
- 1 つの診断設定では、各宛先を 1 つだけ定義することができます。 特定の種類の複数の送信先 (たとえば、2 つの異なる Log Analytics ワークスペース) にデータを送信する場合は、複数の設定を作成します。 各リソースには、最大 5 つの診断設定を作成できます。
重要
アンケート データを受信して分析するには、Azure Monitor で [診断設定] を有効にして、アンケートのログ データを Log Analytics ワークスペース、Event Hubs、または Azure ストレージ アカウントに送信する必要があります。 これらのオプションのいずれかにアンケート データを送信しない場合、アンケート データは保存されず、失われます。Communications Services のログとメトリックの作成を開始するように Azure Monitor リソースを構成する手順について、次で説明します。 すべての Azure リソースで診断設定を使用する方法の詳細については、診断設定のログ記録の有効化に関する記事を参照してください
Note
[診断設定名] で、[通話アンケート] を選択して、通話終了アンケートのログを有効にしてください。
概要
通話終了アンケート ログが実装されているということは、Azure Communication Services (Azure Communication Services) 内の機能が強化されていることを表し、Contoso はアンケートを送信して、通話エクスペリエンスに関するお客様の主観的なフィードバックを収集できます。 音声とビデオのビットレート、ジッター、待機時間などの客観的なメトリックでは、お客様がエクスペリエンスに満足しているかいないかを完全には把握できない可能性があるため、このアプローチでは、それ以外で通話品質の評価を補完することを目的としています。 Azure ログを利用してアンケート データを公開および調査することで、Contoso は改善が必要な領域の分析と特定に関する分析情報を得ることができます。 このアンケート結果は、Azure Communication Services が品質と信頼性を継続的に監視して強化するための貴重なリソースとして機能します。 通話終了アンケートの詳細をご確認ください
通話終了アンケートは、エンドユーザーが JavaScript または Web SDK 通話ソリューションの品質と信頼性をどのように認識しているかの分析情報を収集できるようにする貴重なツールです。 付随するログには、次のようなエンドユーザーのエクスペリエンスを評価するのに役立つ重要なデータが含まれています。
全体的な通話: 回答は、通話の参加者が全体的な通話品質をどのように認識したかを示します。
- 音声: 回答は、ユーザーが音声の問題を認識したかどうかを示します。
- ビデオ: 回答は、ユーザーがビデオの問題を認識したかどうかを示します。
- 画面共有: 回答は、ユーザーが画面共有の問題を認識したかどうかを示します。 上記に加えて、応答の省略可能なタグは、音声、ビデオ、画面共有に関連する特定の種類の問題に関する追加の分析情報を提供します。
通話終了アンケート ログでキャプチャされたデータを分析することで、改善が必要な領域を特定し、全体的なユーザー エクスペリエンスを向上させることができます。
リソース ログのカテゴリ
Communication Services には、有効にできる次のログが用意されています。
- 通話終了アンケート ログ - 通話終了時のアンケートに関連する基本情報を提供します
プロパティ
| Property | 説明 |
|---|---|
Timegenerated |
このフィールドは、ログが生成されたときのタイムスタンプ (UTC) を表します |
CorrelationId |
相関イベントの ID は、複数のテーブル間で相関性のあるイベントを特定する際に使用できます |
Category |
イベントのログ カテゴリ。 ログ カテゴリとリソースの種類が同じログには、同じプロパティ フィールドがあります |
ResourceId |
ユーザーのリソースの完全な長さの識別子 |
OperationName |
ログ レコードに関連付けられている操作 |
OperationVersion |
operationName が API を使用して実行された場合、API バージョンは操作または操作のバージョンに関連付けられています |
CallId |
関連付けに使用される通話の識別子。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます |
ParticipantId |
参加者の ID |
SurveyId |
参加者によって送信されたアンケートの識別子。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます |
OverallCallIssues |
このフィールドは、通話全体に関連する問題を示し、その値は説明のコンマ区切りのリストです |
AudioIssues |
このフィールドは、音声エクスペリエンスに関連する問題を示し、その値は説明のコンマ区切りのリストです |
VideoIssues |
このフィールドは、ビデオ エクスペリエンスに関連する問題を示し、その値は説明のコンマ区切りのリストです |
ScreenshareIssues |
このフィールドは、画面共有エクスペリエンスに関連する問題を示し、その値は説明のコンマ区切りのリストです |
OverallRatingScore |
このフィールドは、参加者によって評価された全体的な通話エクスペリエンスを表します |
OverallRatingScoreLowerBound |
このフィールドは、OverallRatingScore スケールの最小値を表します |
OverallRatingScoreUpperBound |
このフィールドは、OverallRatingScore スケールの最大値を表します |
OverallRatingScoreThreshold |
このフィールドは、OverallRatingScore が品質の向上を示す値を示します |
AudioRatingScore |
このフィールドは、参加者によって評価された音声エクスペリエンスを表します |
AudioRatingScoreLowerBound |
このフィールドは、AudioRatingScore スケールの最小値を表します |
AudioRatingScoreUpperBound |
このフィールドは、AudioRatingScore スケールの最大値を表します |
AudioRatingScoreThreshold |
このフィールドは、AudioRatingScore が品質の向上を示す値を示します |
VideoRatingScore |
このフィールドは、参加者によって評価されたビデオ エクスペリエンスを表します |
VideoRatingScoreLowerBound |
このフィールドは、VideoRatingScore スケールの最小値を表します |
VideoRatingScoreUpperBound |
このフィールドは、VideoRatingScore スケールの最大値を表します |
VideoRatingScoreThreshold |
このフィールドは、VideoRatingScore が品質の向上を示す値を示します |
ScreenshareRatingScore |
このフィールドは、参加者によって評価された画面共有エクスペリエンスを表します |
ScreenshareLowerBound |
このフィールドは、ScreenshareRatingScore スケールの最小値を表します |
ScreenshareUpperBound |
このフィールドは、ScreenshareRatingScore スケールの最大値を表します |
ScreenshareRatingThreshold |
このフィールドは、ScreenshareRatingScore が品質の向上を示す値を示します |
ログの例
全体的な通話の例
[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z",
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey",
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY",
"OperationName":"CallSurvey",
"OperationVersion":"0.0"
"properties":
{
"CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
"SurveyId":"a6dd61c4-b924-4885-96a4-a991d4c09e8b",
"ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"OverallCallIssues":"CallCannotJoin",
"OverallRatingScore":7,
"OverallRatingScoreLowerBound":0,
"OverallRatingScoreUpperBound":10,
"OverallRatingScoreThreshold":5
}
}
]
音声品質の例
[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z",
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey",
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY",
"OperationName":"EndOfCallSurvey",
"OperationVersion":"0.0"
"properties":
{
"CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
"SurveyId":"a6dd61c4-xxxx-4885-96a4-a991d4c09e8b",
"ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"AudioIssues":"NoRemoteAudio",
"AudioRatingScore":6,
"AudioRatingScoreLowerBound":0,
"AudioRatingScoreUpperBound":10,
"AudioRatingScoreThreshold":4
}
]
ビデオ品質の例
[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z",
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey",
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY",
"OperationName":"CallSurvey",
"OperationVersion":"0.0"
"properties":
{
"CallId":"fcc87f7f-ce69-eeed-7777-b036051faea4",
"SurveyId":"a6dd61c4-zzzz-4885-tttt-a991d4c09e8b",
"ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"VideoIssues":"NoVideoReceived",
"VideoRatingScore":9,
"VideoRatingScoreLowerBound":0,
"VideoRatingScoreUpperBound":10,
"VideoRatingScoreThreshold":7
}
}
]
画面共有の例
[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z",
"TimeGenerated":"2023-04-12T14:21:35.0700920Z",
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey",
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY",
"OperationName":"EndOfCallSurvey",
"OperationVersion":"0.0"
"properties":
{
"CallId":"1237f7f-ce69-ffff-b73f-b036051f6666",
"SurveyId":"a6dd6bbb-b924-zzzz-96a4-a991d4c01000",
"ParticipantId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"ScreenshareIssues":"StoppedUnexpectedly,CannotPresent",
"ScreenshareRatingScore":2,
"ScreenshareRatingScoreLowerBound":0,
"ScreenshareRatingScoreUpperBound":10,
"ScreenshareRatingScoreThreshold":3
}
}
]