通話終了調査を使用してユーザーのフィードバックを収集する

• Node.js のアクティブな長期サポート (LTS) バージョンをお勧めします。

API 使用の例

通話終了調査機能は、通話終了後に使用する必要があります。 ユーザーは、1 対 1、グループ、会議、発信、着信など、あらゆる種類の VoIP 通話を評価することができます。 ユーザーの通話が終了すると、アプリケーションはエンド ユーザーに UI を表示して、評価スコアを選択できるようにし、必要に応じて、通話中に発生した問題を事前に定義された一覧から選択できるようにします。

次の切り取りコードは、1 対 1 通話の例を示しています。 通話が終了すると、アプリケーションがアンケート UI を表示します。ユーザーが評価を選択したら、アプリケーションは機能 API を呼び出して、ユーザーの選択肢を含むアンケートを送信する必要があります。

既定の評価スケールを使用することをお勧めします。 ただし、カスタム評価スケールを使用してアンケートを送信することはできます。 API の使用例については、サンプル アプリケーションを確認してください。

通話のみ評価 - カスタム スケールなし

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 5 }, // issues are optional
}).then(() => console.log('survey submitted successfully'));

OverallRating は、すべてのアンケートに必要なカテゴリです。

通話のみ評価 - カスタム スケールと問題あり

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: {
        score: 1, // my score
        scale: { // my custom scale
            lowerBound: 0,
            upperBound: 1,
            lowScoreThreshold: 0
        },
        issues: ['HadToRejoin'] // my issues, check the table below for all available issues
    }
}).then(() => console.log('survey submitted successfully'));

サンプル問題で総合、オーディオ、ビデオを評価

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 3 },
    audioRating: { score: 4 },
    videoRating: { score: 3, issues: ['Freezes'] }
}).then(() => console.log('survey submitted successfully'))

SDK が送信できるエラーを処理する

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 3 }
}).catch((e) => console.log('error when submitting survey: ' + e))

さまざまな種類のエラーを見つける

アンケート送信時のエラー

データの検証に失敗した場合、またはアンケートを送信できない場合、API は次のエラー メッセージを返します。

• 少なくとも 1 つのアンケートの評価が必要です。

• 既定ではスケール X は 1 ～ 5 でなければなりません。 - X は次のいずれかです。

  • overallRating.score
  • audioRating.score
  • videoRating.score
  • ScreenshareRating.score

• {propertyName}: {rating.score} は {rating.scale?.lowerBound} と {rating.scale?.upperBound} の間でなければなりません。

• {propertyName}: {rating.scale?.lowScoreThreshold} は {rating.scale?.lowerBound} と {rating.scale?.upperBound} の間でなければなりません。

• {propertyName} lowerBound: {rating.scale?.lowerBound} と upperBound: {rating.scale?.upperBound} は 0 と 100 の間でなければなりません。

• もう一度お試しください [ネットワーク エラーまたはその他のエラーが原因で ACS がアンケートを送信できませんでした]。

メッセージと共にエラー コードが返されます。

• 1 つを除くすべてのエラー メッセージでエラー コード 400 (不正な要求)。

{ message: validationErrorMessage, code: 400 }

• イベントが破棄されたときの 1回の 408 (タイムアウト):

{ message: "Please try again.", code: 408 }

すべての可能な値

既定のアンケート API 構成

その他のアンケート タグ

カスタマイズ オプション

4 つの API 値のそれぞれを収集することも、最も重要と思われるものだけを収集することも可能です。 たとえば、オーディオ、ビデオ、画面共有の体験についてお客様に尋ねるのではなく、全体的な通話体験についてのみ尋ねるように選択することができます。 また、入力範囲をニーズに合わせてカスタマイズすることもできます。 既定の入力範囲は、全体的な通話、オーディオ、ビデオ、画面共有では 1 ～ 5 です。 ただし、それぞれの API 値を最小 0 から最大 100 までカスタマイズできます。

カスタマイズの例

カスタム質問

通話終了アンケート API を使うだけでなく、独自のアンケートの質問を作成し、それらを通話終了アンケートの結果に組み込むことができます。 以下では、顧客への独自の質問をアンケートに組み込み、通話終了アンケート API の結果と独自のアンケートの質問のクエリを実行する手順を示します。

• App Insight リソースを作成します。

• Azure AppInsights をアプリケーションに埋め込みます。プレーンな JavaScript を使用した App Insight の初期化の詳細については、こちらをクリックしてください。 または、NPM を使用して App Insights の依存関係を取得することもできます。 NPM を使用した App Insight の初期化の詳細については、こちらをクリックしてください。

• カスタムの質問をユーザーに提供し、その入力を収集する UI をアプリケーションで作成します。アプリケーションは応答を improvementSuggestion 変数に文字列として収集するものとします

• アンケート結果を ACS に送信し、App Insights を使用してユーザーの応答を送信します。

  currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
  // `improvementSuggesstion` contains custom, user response
      if (improvementSuggestion !== '') {
          appInsights.trackEvent({
                  name: "CallSurvey", properties: {
                      // Survey ID to correlate the survey
                      id: res.id,
                      // Other custom properties as key value pair
                      improvementSuggestion: improvementSuggestion
                  }
              });
       }
  });
  appInsights.flush();
  

AppInsights を使用して送信されたユーザーの応答は、App Insights ワークスペースで使用できます。 ブックを使用して、複数のリソース間でクエリを実行し、通話の評価とカスタムのアンケート データを関連付けることができます。 通話の評価とカスタムのアンケート データを関連付ける手順:

• 新しいブックを作成し ([ACS リソース] -> [監視] -> [ブック] -> [新規])、ACS リソースから通話アンケート データのクエリを実行します。
• 新しいクエリを追加します ([+追加] -> [クエリの追加])
• Data source が Logs で、Resource type が Communication であることを確認します
• クエリの名前を変更できます ([詳細設定] -> [ステップ名] [例: call-survey])
• アンケート データが Azure portal に表示されるまでに最大 2 時間かかる場合があることに注意してください。 通話の評価データのクエリを実行します。

  ACSCallSurvey
  | where TimeGenerated > now(-24h)
  

• App Insights からデータを取得するための別のクエリを追加します ([+追加] -> [クエリの追加])
• Data source が Logs で、Resource type が Application Insights であることを確認します
• カスタム イベントのクエリを実行します。

  customEvents
  | where timestamp > now(-24h)
  | where name == 'CallSurvey'
  | extend d=parse_json(customDimensions)
  | project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
  

• クエリの名前を変更できます ([詳細設定] -> [ステップ名] [例: custom-call-survey])
• 最後に、これら 2 つのクエリを surveyId でマージします。 新しいクエリを作成します ([+追加] -> [クエリの追加])。
• Data source が Merge であることを確認し、必要に応じて Merge type を選びます

title: Azure Communication Services の通話終了アンケート titleSuffix: Azure Communication Services チュートリアル ドキュメント description: 通話終了アンケートを使用してユーザーのフィードバックを収集する方法について説明します。 author: viniciusl-msft ms.author: viniciusl manager: gaobob services: azure-communication-services ms.date: 7/30/2024 ms.topic: tutorial ms.service: azure-communication-services ms.subservice: calling

API 使用の例

通話終了調査機能は、通話終了後に使用する必要があります。 ユーザーは、1 対 1、グループ、会議、発信、着信など、あらゆる種類の VoIP 通話を評価することができます。 ユーザーの通話が終了すると、アプリケーションはエンド ユーザーに UI を表示して、評価スコアを選択できるようにし、必要に応じて、通話中に発生した問題を事前に定義された一覧から選択できるようにします。

次の切り取りコードは、1 対 1 通話の例を示しています。 通話が終了すると、アプリケーションがアンケート UI を表示します。ユーザーが評価を選択したら、アプリケーションは機能 API を呼び出して、ユーザーの選択肢を含むアンケートを送信する必要があります。

既定の評価スケール (1 から 5) を使うことをお勧めします。 ただし、カスタム評価スケールを使用してアンケートを送信することはできます。

アンケートを開始する

アンケートを開始して、CallSurvey オブジェクトを作成します。 これにより、アンケートの意図が記録されます。 この特定の CallSurvey オブジェクトが後で送信されない場合は、アンケートがエンド カスタマーによってスキップまたは無視されたことを意味します。

SurveyCallFeature surveyCallFeature = call.feature(Features.SURVEY);
try {
    CallSurvey survey = surveyCallFeature.startSurvey().get();
} catch (InterruptedException | ExecutionException e) {
    // failure to start survey
}

一般的な使用

評価を呼び出すときは、スケール フィールドで定義されている値を考慮する必要があります。 lowerBound の値は考えられる最悪のエクスペリエンスを示し、upperBound の値は完璧なエクスペリエンスを意味します。 どちらの値もそれ自体を含みます。

OverallRating は、すべてのアンケートに必要なカテゴリです。

アンケートの推奨される使用方法について詳しくは、アンケートの概念に関する記事をご覧ください

通話のみ評価 - カスタム スケールなし

SurveyScore overall = new SurveyScore();
overall.setScore(5);
callSurvey.setOverallScore(overall);

通話のみ評価 - カスタム スケールと問題あり

// configuring scale
CallSurveyRatingScale ratingScale = new CallSurveyRatingScale();
ratingScale.setLowerBound(0);
ratingScale.setLowerBound(1);
ratingScale.setLowScoreThreshold(0);
SurveyScore overall = new SurveyScore();
overall.setScale(ratingScale);

// setting score according to scale
overall.setScore(1);
callSurvey.setOverallScore(overall);
// reporting one or more issues
callSurvey.setCallIssues(CallIssues.HAD_TO_REJOIN);

サンプル問題で総合、オーディオ、ビデオを評価

SurveyScore overall = new SurveyScore();
overall.setScore(3);
SurveyScore audio = new SurveyScore();
audio.setScore(4);
SurveyScore video = new SurveyScore();
video.setScore(3);
callSurvey.setOverallScore(overall);
callSurvey.setAudioScore(audio);
callSurvey.setVideoScore(video);
callSurvey.setVideoIssues(VideoIssues.FREEZES);

アンケートを送信し、SDK が送信する可能性のあるエラーを処理する

try {
    CallSurveyResult survey = surveyCallFeature.submitSurvey(survey).get();
} catch (InterruptedException e) {
    // Threading error
} catch (ExecutionException e) {
    Log.e("SURVEY", e.getCause().getMessage());
}

さまざまな種類のエラーを見つける

アンケート送信時のエラー:

submitSurvey API は、次のシナリオでエラーを返す可能性があります。

• 全体的なアンケート評価が必要です。

• CallSurveyRatingScale の境界は、0 から 100 の範囲内である必要があります。 LowerBound は UpperBound より小さくする必要があります。 LowScoreThreshold は境界内にある必要があります。

• すべてのスコアでは、CallSurveyRatingScale によって定義される境界を考慮する必要があります。 CallSurveyRatingScale オブジェクト内のすべての値が含まれます。 既定のスケールを使う場合、スコア値は 1 から 5 の間である必要があります。

• ネットワークまたはサービスのエラーのため、アンケートを送信できません。

利用できるアンケート タグ

全体的な呼び出し

オーディオに関する問題

ビデオの問題

画面共有の問題

カスタマイズ オプション

4 つの API 値のそれぞれを収集することも、最も重要と思われるものだけを収集することも可能です。 たとえば、オーディオ、ビデオ、画面共有の体験についてお客様に尋ねるのではなく、全体的な通話体験についてのみ尋ねるように選択することができます。 また、入力範囲をニーズに合わせてカスタマイズすることもできます。 既定の入力範囲は、全体的な通話、オーディオ、ビデオ、画面共有では 1 から 5 です。 ただし、それぞれの API 値を最小 0 から最大 100 までカスタマイズできます。

カスタム質問

通話終了アンケート API を使うだけでなく、独自のアンケートの質問を作成し、それらを通話終了アンケートの結果に組み込むことができます。

SubmitSurvey 操作の結果ペイロードで提供されるデータを使って、ACS アンケートのデータと独自のカスタム データおよびストレージを関連付けることができます。 CallSurveyResult クラスの SurveyId フィールドはアンケートの一意の識別子を表し、CallId はアンケートが生成された通話の識別子を表します。 これらの識別子をカスタマイズしたデータと共に保存すると、データを一意に関連付けることができます。

API 使用の例

通話終了調査機能は、通話終了後に使用する必要があります。 ユーザーは、1 対 1、グループ、会議、発信、着信など、あらゆる種類の VoIP 通話を評価することができます。 ユーザーの通話が終了すると、アプリケーションはエンド ユーザーに UI を表示して、評価スコアを選択できるようにし、必要に応じて、通話中に発生した問題を事前に定義された一覧から選択できるようにします。

次の切り取りコードは、1 対 1 通話の例を示しています。 通話が終了すると、アプリケーションがアンケート UI を表示します。ユーザーが評価を選択したら、アプリケーションは機能 API を呼び出して、ユーザーの選択肢を含むアンケートを送信する必要があります。

既定の評価スケール (1 から 5) を使うことをお勧めします。 ただし、カスタム評価スケールを使用してアンケートを送信することはできます。

アンケートを開始する

アンケートを開始して、CallSurvey オブジェクトを作成します。 これにより、アンケートの意図が記録されます。 この特定の CallSurvey オブジェクトが後で送信されない場合は、アンケートがエンド カスタマーによってスキップまたは無視されたことを意味します。

var surveyCallFeature = self.call.feature(Features.survey)
do {
    try self.callSurvey = await surveyFeature.startSurvey()
} catch {
    print("Failure to start survey")
}

一般的な使用

評価を呼び出すときは、スケール フィールドで定義されている値を考慮する必要があります。 lowerBound の値は考えられる最悪のエクスペリエンスを示し、upperBound の値は完璧なエクスペリエンスを意味します。 どちらの値もそれ自体を含みます。

OverallRating は、すべてのアンケートに必要なカテゴリです。

アンケートの推奨される使用方法について詳しくは、アンケートの概念に関する記事をご覧ください

通話のみ評価 - カスタム スケールなし

let overallScore = SurveyScore()
overallScore.score = Int32(5)
callSurvey.overallScore = overallScore

通話のみ評価 - カスタム スケールと問題あり

// configuring scale
var ratingScale = new CallSurveyRatingScale()
ratingScale.lowerBound = 0;
ratingScale.upperBound = 1;
ratingScale.lowScoreThreshold = 0;
SurveyScore overall = new SurveyScore();
overall.scale = ratingScale;
// setting score according to scale
overall.score = 1;

callSurvey.overallScore = overall;

// reporting one or more issues
callSurvey.callIssues = [ CallIssues.hadToRejoin ];

サンプル問題で総合、オーディオ、ビデオを評価

let overall = SurveyScore();
overall.score  = 3;

let audio = SurveyScore();
audio.score = 4;

let video = SurveyScore();
video.score = 3;

callSurvey.overallScore = overall;
callSurvey.audioScore = audio;
callSurvey.videoScore = video;
callSurvey.videoIssues = [ VideoIssues.freezes ];

アンケートを送信し、SDK が送信する可能性のあるエラーを処理する

do {
    var result =  try await self.surveyFeature!.submit(survey: callSurvey)
} catch let error as NSError {
    print("==> Survey Not Submitted " + error.localizedDescription)
}

さまざまな種類のエラーを見つける

アンケート送信時のエラー:

submitSurvey API は、次のシナリオでエラーを返す可能性があります。

• 全体的なアンケート評価が必要です。

• CallSurveyRatingScale の境界は、0 から 100 の範囲内である必要があります。 LowerBound は UpperBound より小さくする必要があります。 LowScoreThreshold は境界内にある必要があります。

• すべてのスコアでは、CallSurveyRatingScale によって定義される境界を考慮する必要があります。 CallSurveyRatingScale オブジェクト内のすべての値が含まれます。 既定のスケールを使う場合、スコア値は 1 から 5 の間である必要があります。

• ネットワークまたはサービスのエラーのため、アンケートを送信できません。

利用できるアンケート タグ

全体的な呼び出し

オーディオに関する問題

ビデオの問題

画面共有の問題

カスタマイズ オプション

4 つの API 値のそれぞれを収集することも、最も重要と思われるものだけを収集することも可能です。 たとえば、オーディオ、ビデオ、画面共有の体験についてお客様に尋ねるのではなく、全体的な通話体験についてのみ尋ねるように選択することができます。 また、入力範囲をニーズに合わせてカスタマイズすることもできます。 既定の入力範囲は、全体的な通話、オーディオ、ビデオ、画面共有では 1 から 5 です。 ただし、それぞれの API 値を最小 0 から最大 100 までカスタマイズできます。

カスタム質問

通話終了アンケート API を使うだけでなく、独自のアンケートの質問を作成し、それらを通話終了アンケートの結果に組み込むことができます。

ただし、SubmitSurvey 操作の結果ペイロードで提供されるデータを使って、ACS アンケートのデータと独自のカスタム データおよびストレージを関連付けることができます。 CallSurveyResult クラスの SurveyId フィールドはアンケートの一意の識別子を表し、CallId はアンケートが生成された通話の識別子を表します。 これらの識別子をカスタマイズしたデータと共に保存すると、データを一意に関連付けることができます。

API 使用の例

通話終了調査機能は、通話終了後に使用する必要があります。 ユーザーは、1 対 1、グループ、会議、発信、着信など、あらゆる種類の VoIP 通話を評価することができます。 ユーザーの通話が終了すると、アプリケーションはエンド ユーザーに UI を表示して、評価スコアを選択できるようにし、必要に応じて、通話中に発生した問題を事前に定義された一覧から選択できるようにします。

次の切り取りコードは、1 対 1 通話の例を示しています。 通話が終了すると、アプリケーションがアンケート UI を表示します。ユーザーが評価を選択したら、アプリケーションは機能 API を呼び出して、ユーザーの選択肢を含むアンケートを送信する必要があります。

既定の評価スケール (1 から 5) を使うことをお勧めします。 ただし、カスタム評価スケールを使用してアンケートを送信することはできます。

アンケートを開始する

アンケートを開始して、CallSurvey オブジェクトを作成します。 これにより、アンケートの意図が記録されます。 この特定の CallSurvey オブジェクトが後で送信されない場合は、アンケートがエンド カスタマーによってスキップまたは無視されたことを意味します。

var surveyCallFeature = call.Features.Survey;
var survey = await surveyCallFeature.StartSurveyAsync();

一般的な使用

評価を呼び出すときは、スケール フィールドで定義されている値を考慮する必要があります。 lowerBound の値は考えられる最悪のエクスペリエンスを示し、upperBound の値は完璧なエクスペリエンスを意味します。 どちらの値もそれ自体を含みます。

OverallRating は、すべてのアンケートに必要なカテゴリです。

アンケートの推奨される使用方法について詳しくは、アンケートの概念に関する記事をご覧ください

通話のみ評価 - カスタム スケールなし

survey.OverallScore = new CallSurveyScore() { Score = 5 };

通話のみ評価 - カスタム スケールと問題あり

// configuring scale and score
survey.OverallScore = new CallSurveyScore() { 
    Scale = new CallSurveyRatingScale() { 
                LowerBound = 0,
                UpperBound = 1,
                LowScoreThreshold = 1,
            }, 
            Score = 1 
};

// reporting one or more issues
survey.OverallIssues = CallIssues.HadToRejoin;

サンプル問題で総合、オーディオ、ビデオを評価

survey.OverallScore = new CallSurveyScore() { 
    Score = 5 
};
survey.AudioScore = new CallSurveyScore() { 
    Score = 4
};
survey.VideoScore = new CallSurveyScore() { 
    Score = 3
};

survey.videoIssues = VideoIssues.Freezes;

アンケートを送信し、SDK が送信する可能性のあるエラーを処理する

try
{
    CallSurveyResult result = await surveyCallFeature.SubmitSurveyAsync(survey);
    Console.WriteLine("Survey submitted" + result.SurveyId);
} catch (Exception ex)
{
   Console.WriteLine(ex.Message);
}

さまざまな種類のエラーを見つける

アンケート送信時のエラー:

submitSurvey API は、次のシナリオでエラーを返す可能性があります。

• 全体的なアンケート評価が必要です。

• CallSurveyRatingScale の境界は、0 から 100 の範囲内である必要があります。 LowerBound は UpperBound より小さくする必要があります。 LowScoreThreshold は境界内にある必要があります。

• すべてのスコアでは、CallSurveyRatingScale によって定義される境界を考慮する必要があります。 CallSurveyRatingScale オブジェクト内のすべての値が含まれます。 既定のスケールを使う場合、スコア値は 1 から 5 の間である必要があります。

• ネットワークまたはサービスのエラーのため、アンケートを送信できません。

利用できるアンケート タグ

全体的な呼び出し

オーディオの問題

ビデオの問題

画面共有の問題

カスタマイズ オプション

4 つの API 値のそれぞれを収集することも、最も重要と思われるものだけを収集することも可能です。 たとえば、オーディオ、ビデオ、画面共有の体験についてお客様に尋ねるのではなく、全体的な通話体験についてのみ尋ねるように選択することができます。 また、入力範囲をニーズに合わせてカスタマイズすることもできます。 既定の入力範囲は、全体的な通話、オーディオ、ビデオ、画面共有では 1 から 5 です。 ただし、それぞれの API 値を最小 0 から最大 100 までカスタマイズできます。

カスタム質問

通話終了アンケート API を使うだけでなく、独自のアンケートの質問を作成し、それらを通話終了アンケートの結果に組み込むことができます。

ただし、SubmitSurvey 操作の結果ペイロードで提供されるデータを使って、ACS アンケートのデータと独自のカスタム データおよびストレージを関連付けることができます。 CallSurveyResult クラスの SurveyId フィールドはアンケートの一意の識別子を表し、CallId はアンケートが生成された通話の識別子を表します。 これらの識別子をカスタマイズしたデータと共に保存すると、データを一意に関連付けることができます。