Bagikan melalui

Gunakan Survei Akhir Panggilan untuk mengumpulkan umpan balik pengguna

  • Artikel

Catatan

Akhir Survei Panggilan saat ini hanya didukung untuk JavaScript / Web SDK kami.

Tutorial ini menunjukkan kepada Anda cara menggunakan Survei Akhir Panggilan Azure Communication Services untuk JavaScript / Web SDK.

Prasyarat

  • Akun Azure dengan langganan aktif. Buat akun secara gratis.

  • Node.js versi Dukungan Jangka Panjang (LTS) aktif disarankan.

  • Sumber daya Azure Communication Services aktif. Buat sumber daya Azure Communication Services. Hasil survei terkait dengan satu sumber daya Communication Services.

  • Ruang Kerja Analitik Log aktif, juga dikenal sebagai Log Azure Monitor. Lihat Akhir Log Survei Panggilan.

  • Untuk melakukan survei dengan pertanyaan kustom menggunakan teks formulir gratis, Anda memerlukan sumber daya App Insight.

Penting

Akhir Survei Panggilan tersedia mulai versi 1.13.1 dari SDK Panggilan. Pastikan untuk menggunakan versi tersebut atau yang lebih baru saat mencoba instruksi.

Sampel penggunaan API

Fitur Akhir Survei Panggilan harus digunakan setelah panggilan berakhir. Pengguna dapat menilai semua jenis panggilan VoIP, 1:1, grup, rapat, keluar dan masuk. Setelah panggilan pengguna berakhir, aplikasi Anda dapat menampilkan UI kepada pengguna akhir yang memungkinkan mereka memilih skor peringkat, dan jika diperlukan, pilih masalah yang mereka temui selama panggilan dari daftar yang telah ditentukan sebelumnya.

Cuplikan kode berikut menunjukkan contoh panggilan satu ke satu. Setelah akhir panggilan, aplikasi Anda dapat menampilkan UI survei dan setelah pengguna memilih peringkat, aplikasi Anda harus memanggil API fitur untuk mengirimkan survei dengan pilihan pengguna.

Kami mendorong Anda untuk menggunakan skala peringkat default. Namun, Anda dapat mengirimkan survei dengan skala peringkat kustom. Anda dapat memeriksa aplikasi sampel untuk contoh penggunaan API.

Panggilan tarif saja - tidak ada skala kustom

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

OverallRating adalah kategori yang diperlukan untuk semua survei.

Panggilan tarif saja - dengan skala dan masalah kustom

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'));

Beri peringkat keseluruhan, audio, dan video dengan masalah sampel

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

Menangani kesalahan yang dapat dikirim SDK

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

Menemukan berbagai jenis kesalahan

Kegagalan saat mengirimkan survei:

API akan mengembalikan pesan kesalahan berikut jika validasi data gagal atau survei tidak dapat dikirimkan.

  • Setidaknya satu peringkat survei diperlukan.

  • Dalam skala default X harus 1 hingga 5. - di mana X adalah salah satu dari:

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

  • {propertyName}: {rating.score} harus berada di antara {rating.scale?. lowerBound} dan {rating.scale?. upperBound}.

  • {propertyName}: {rating.scale?. lowScoreThreshold} harus berada di antara {rating.scale?. lowerBound} dan {rating.scale?. upperBound}.

  • {propertyName} lowerBound: {rating.scale?. lowerBound} dan upperBound: {rating.scale?. upperBound} harus antara 0 dan 100.

  • Silakan coba lagi [Azure Communication Services gagal mengirimkan survei, karena jaringan atau kesalahan lainnya].

Kami akan mengembalikan kode kesalahan apa pun dengan pesan.

  • Kode kesalahan 400 (permintaan buruk) untuk semua pesan kesalahan kecuali satu.
{ message: validationErrorMessage, code: 400 }
  • Satu 408 (waktu habis) ketika peristiwa dibuang:
{ message: "Please try again.", code: 408 }

Semua nilai yang mungkin

Konfigurasi API survei default

Kategori Peringkat API Nilai Cutoff* Rentang Input Komentar
Panggilan Keseluruhan 2 1 - 5 Survei pengalaman kualitas keseluruhan peserta panggilan pada skala 1-5. Respons 1 menunjukkan pengalaman panggilan yang tidak sempurna dan 5 menunjukkan panggilan yang sempurna. Nilai cutoff 2 berarti bahwa respons pelanggan 1 atau 2 menunjukkan pengalaman panggilan yang kurang sempurna.
Audio 2 1 - 5 Respons 1 menunjukkan pengalaman audio yang tidak sempurna dan 5 menunjukkan tidak ada masalah audio yang dialami.
Video 2 1 - 5 Respons 1 menunjukkan pengalaman video yang tidak sempurna dan 5 menunjukkan tidak ada masalah video yang dialami.
Screenshare 2 1 - 5 Respons 1 menunjukkan pengalaman berbagi layar yang tidak sempurna dan 5 menunjukkan tidak ada masalah berbagi layar yang dialami.

Catatan

Nilai cutoff yang ditunjukkan pertanyaan dalam API adalah ambang yang digunakan Microsoft saat menganalisis data survei Anda. Saat Anda menyesuaikan nilai cutoff atau Rentang Input, Microsoft menganalisis data survei Anda sesuai dengan penyesuaian Anda.

Tag survei lainnya

Kategori Peringkat Tag Opsional
Panggilan Keseluruhan CallCannotJoin CallCannotInvite HadToRejoin CallEndedUnexpectedly OtherIssues
Audio NoLocalAudio NoRemoteAudio Echo AudioNoise LowVolume AudioStoppedUnexpectedly DistortedSpeech AudioInterruption OtherIssues
Video NoVideoReceived NoVideoSent LowQuality Freezes StoppedUnexpectedly DarkVideoReceived AudioVideoOutOfSync OtherIssues
Screenshare NoContentLocal NoContentRemote CannotPresent LowQuality Freezes StoppedUnexpectedly LargeDelay OtherIssues

Opsi penyesuaian

Anda dapat memilih untuk mengumpulkan masing-masing dari empat nilai API atau hanya nilai yang paling penting yang Anda temukan. Misalnya, Anda dapat memilih untuk hanya bertanya kepada pelanggan tentang pengalaman panggilan mereka secara keseluruhan alih-alih bertanya kepada mereka tentang pengalaman audio, video, dan berbagi layar mereka. Anda juga dapat menyesuaikan rentang input agar sesuai dengan kebutuhan Anda. Rentang input default adalah 1 hingga 5 untuk Panggilan Keseluruhan, Audio, Video, dan Screenshare. Namun, setiap nilai API dapat disesuaikan dari minimal 0 hingga maksimum 100.

Contoh kustomisasi

Kategori Peringkat API Nilai Cutoff* Rentang Input
Panggilan Keseluruhan 0 - 100 0 - 100
Audio 0 - 100 0 - 100
Video 0 - 100 0 - 100
Screenshare 0 - 100 0 - 100

Catatan

Nilai cutoff yang ditunjukkan pertanyaan dalam API adalah ambang yang digunakan Microsoft saat menganalisis data survei Anda. Saat Anda menyesuaikan nilai cutoff atau Rentang Input, Microsoft menganalisis data survei Anda sesuai dengan penyesuaian Anda.

Pertanyaan kustom

Selain menggunakan API Survei Akhir Panggilan, Anda dapat membuat pertanyaan survei Anda sendiri dan menggabungkannya dengan hasil Survei Akhir Panggilan. Di bawah ini Anda akan menemukan langkah-langkah untuk memasukkan pertanyaan pelanggan Anda sendiri ke dalam survei dan mengkueri hasil API Survei Akhir Panggilan dan pertanyaan survei Anda sendiri.

  • Buat sumber daya App Insight.

  • Sematkan Azure AppInsights ke dalam aplikasi Anda Klik di sini untuk mengetahui lebih lanjut tentang inisialisasi App Insight menggunakan JavaScript biasa. Atau, Anda dapat menggunakan NPM untuk mendapatkan dependensi App Insights. Klik di sini untuk mengetahui lebih lanjut tentang inisialisasi App Insight menggunakan NPM.

  • Membangun UI di aplikasi Anda yang akan menyajikan pertanyaan kustom kepada pengguna dan mengumpulkan input mereka, mari kita asumsikan bahwa aplikasi Anda mengumpulkan respons sebagai string dalam improvementSuggestion variabel

  • Kirim hasil survei ke Azure Communication Services dan kirim respons pengguna menggunakan 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();

Respons pengguna yang dikirim menggunakan AppInsights tersedia di bawah ruang kerja App Insights Anda. Anda bisa menggunakan Buku Kerja untuk mengkueri antara beberapa sumber daya, menghubungkan peringkat panggilan dan data survei kustom. Langkah-langkah untuk menghubungkan peringkat panggilan dan data survei kustom:

  • Buat Buku Kerja baru (Sumber Daya Azure Communication Services Anda -> Pemantauan -> Buku Kerja -> Baru) dan kueri data Survei Panggilan dari sumber daya Azure Communication Services Anda.
  • Tambahkan kueri baru (+Tambahkan -> Tambahkan kueri)
  • Pastikan Data source dan Logs Resource type adalah Communication
  • Anda dapat mengganti nama kueri (Pengaturan Tingkat Lanjut -> Nama langkah [contoh: call-survey])
  • Ketahuilah bahwa itu bisa memerlukan maksimum 2 jam sebelum data survei terlihat di portal Azure.. Mengkueri data peringkat panggilan- 
    ACSCallSurvey
| where TimeGenerated > now(-24h)
  • Menambahkan kueri lain untuk mendapatkan data dari App Insights (+Tambahkan -> Tambahkan kueri)
  • Pastikan Data source dan Logs Resource type adalah Application Insights
  • Mengkueri peristiwa kustom- 
    customEvents
| where timestamp > now(-24h)
| where name == 'CallSurvey'
| extend d=parse_json(customDimensions)
| project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
  • Anda dapat mengganti nama kueri (Pengaturan Tingkat Lanjut -> Nama langkah [contoh: custom-call-survey])
  • Terakhir gabungkan kedua kueri ini dengan surveyId. Buat kueri baru (+Tambahkan -> Tambahkan kueri).
  • Jadikan suer Data source adalah Gabungkan dan pilih Merge type sesuai kebutuhan

Mengumpulkan data survei

Penting

Anda harus mengaktifkan Pengaturan Diagnostik di Azure Monitor untuk mengirim data log survei Anda ke ruang kerja Analitik Log, Azure Event Hubs, atau akun penyimpanan Azure untuk menerima dan menganalisis data survei Anda. Jika Anda tidak mengirim data survei ke salah satu opsi ini, data survei Anda tidak akan disimpan dan akan hilang. Untuk mengaktifkan log ini untuk Communications Services Anda, lihat: Akhir Log Survei Panggilan

Melihat data survei dengan ruang kerja Analitik Log

Anda perlu mengaktifkan Ruang Kerja Analitik Log untuk menyimpan data log survei dan mengakses hasil survei Anda. Untuk mengaktifkan log ini untuk Communications Service Anda, lihat: Akhir Log Survei Panggilan.

Praktik terbaik

Berikut adalah alur survei yang direkomendasikan dan permintaan pertanyaan yang disarankan untuk dipertimbangkan. Pengembangan Anda dapat menggunakan rekomendasi kami atau menggunakan permintaan dan alur pertanyaan yang disesuaikan untuk antarmuka visual Anda.

Pertanyaan 1: Bagaimana pengguna melihat pengalaman kualitas panggilan mereka secara keseluruhan? Kami sarankan Anda memulai survei dengan hanya bertanya tentang kualitas keseluruhan peserta. Jika Anda memisahkan pertanyaan pertama dan kedua, ini membantu hanya mengumpulkan respons terhadap masalah Audio, Video, dan Berbagi Layar jika peserta survei menunjukkan mereka mengalami masalah kualitas panggilan.

  • Prompt yang disarankan: "Bagaimana kualitas panggilan?"
  • Nilai Pertanyaan API: Panggilan Keseluruhan

Pertanyaan 2: Apakah pengguna melihat masalah Audio, Video, atau Berbagi Layar dalam panggilan? Jika peserta survei merespons Pertanyaan 1 dengan skor di atau di bawah nilai cutoff untuk panggilan keseluruhan, maka sajikan pertanyaan kedua.

  • Prompt yang disarankan: "Apa yang bisa lebih baik?"
  • Nilai Pertanyaan API: Audio, Video, dan Screenshare

Pedoman Survei

  • Hindari burnout survei, jangan survei semua peserta panggilan.
  • Urutan pertanyaan Anda penting. Kami sarankan Anda mengacak urutan tag opsional di Pertanyaan 2 jika responden memfokuskan sebagian besar umpan balik mereka pada permintaan pertama yang mereka lihat secara visual.
  • Pertimbangkan untuk menggunakan survei untuk Sumber Daya Azure Communication Services terpisah dalam eksperimen terkontrol untuk mengidentifikasi dampak rilis.

Langkah berikutnya