Luncurkan Hub Umpan Balik dari aplikasi Anda

Anda dapat mendorong pelanggan untuk meninggalkan umpan balik dengan menambahkan kontrol (seperti tombol) ke aplikasi Platform Windows Universal (UWP) Anda yang meluncurkan Feedback Hub. Feedback Hub adalah aplikasi yang telah diinstal sebelumnya yang menyediakan satu tempat untuk mengumpulkan umpan balik di Windows dan aplikasi yang diinstal. Semua umpan balik pelanggan yang dikirimkan untuk aplikasi Anda melalui Feedback Hub dikumpulkan dan disajikan kepada Anda dalam laporan Umpan Balik di Pusat Mitra, sehingga Anda dapat melihat masalah, saran, dan upvote yang telah dikirimkan pelanggan Anda dalam satu laporan.

Untuk meluncurkan Feedback Hub dari aplikasi Anda, gunakan API yang disediakan oleh Microsoft Store Services SDK. Kami menyarankan agar Anda menggunakan API ini untuk meluncurkan Feedback Hub dari elemen UI di aplikasi Anda yang mengikuti panduan desain kami.

Catatan

Hub Umpan Balik hanya tersedia di perangkat yang menjalankan Windows versi 10.0.14271 atau yang lebih baru yang didasarkan pada keluarga desktop dan perangkat seluler. Kami menyarankan agar Anda menampilkan kontrol umpan balik di aplikasi Anda hanya jika Hub Umpan Balik tersedia di perangkat pengguna. Kode dalam topik ini menunjukkan cara melakukan ini.

Cara meluncurkan Feedback Hub dari aplikasi Anda

Untuk meluncurkan Feedback Hub dari aplikasi Anda:

1. Instal Microsoft Store Services SDK.
2. Buka proyek Anda di Visual Studio.
3. Di Penjelajah Solusi, klik kanan simpul Referensi untuk proyek Anda dan klik Tambahkan Referensi.
4. Di Reference Manager, perluas Universal Windows dan klik Ekstensi.
5. Dalam daftar SDK, klik kotak centang di samping Microsoft Engagement Framework dan klik OK.
6. Di proyek Anda, tambahkan kontrol yang ingin Anda perlihatkan kepada pengguna untuk meluncurkan Hub Umpan Balik, seperti tombol. Kami menyarankan agar Anda mengonfigurasi kontrol sebagai berikut:

• Atur font konten yang ditampilkan dalam kontrol ke Segoe MDL2 Assets.

• Atur teks dalam kontrol ke kode karakter Unicode heksadesimal E939. Ini adalah kode karakter untuk ikon umpan balik yang direkomendasikan di font Segoe MDL2 Assets .

• Atur visibilitas kontrol ke tersembunyi.

  Catatan

  Kami menyarankan agar Anda menyembunyikan kontrol umpan balik secara default dan menampilkannya dalam kode inisialisasi Anda hanya jika Hub Umpan Balik tersedia di perangkat pengguna. Langkah selanjutnya menunjukkan cara melakukan ini.

  Kode berikut menunjukkan definisi XAML dari Tombol yang dikonfigurasi seperti yang dijelaskan di atas.

  <Button x:Name="feedbackButton" FontFamily="Segoe MDL2 Assets" Content="&#xE939;" HorizontalAlignment="Left" Margin="138,352,0,0" VerticalAlignment="Top" Visibility="Collapsed"  Click="feedbackButton_Click"/>
  

7. Di kode inisialisasi Anda untuk halaman aplikasi yang menghosting kontrol umpan balik Anda, gunakan metode Statis IsSupported dari kelas StoreServicesFeedbackLauncher untuk menentukan apakah Hub Umpan Balik tersedia di perangkat pengguna. Hub Umpan Balik hanya tersedia di perangkat yang menjalankan OS Windows 10 versi 10.0.14271 atau yang lebih baru yang didasarkan pada keluarga desktop dan perangkat seluler.

   Jika properti ini mengembalikan true, buat kontrol terlihat. Kode berikut menunjukkan cara melakukan ini untuk Tombol.

   if (Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.IsSupported())
   {
       this.feedbackButton.Visibility = Visibility.Visible;
   }
   

   Catatan

   Meskipun Feedback Hub tidak didukung pada perangkat Xbox saat ini, properti IsSupported saat ini mengembalikan true pada perangkat Xbox yang menjalankan Windows versi 10.0.14271 atau yang lebih baru. Ini adalah masalah umum yang akan diperbaiki dalam rilis SDK Microsoft Store Services di masa mendatang.

8. Di penanganan aktivitas yang berjalan saat pengguna mengklik kontrol, dapatkan objek StoreServicesFeedbackLauncher dan panggil metode LaunchAsync untuk meluncurkan aplikasi Hub Umpan Balik. Ada dua kelebihan beban untuk metode ini: satu tanpa parameter, dan satu lagi yang menerima kamus pasangan kunci dan nilai yang berisi metadata yang ingin Anda kaitkan dengan umpan balik. Contoh berikut menunjukkan cara meluncurkan Hub Umpan Balik di Klik penanganan aktivitas untuk Tombol.

   private async void feedbackButton_Click(object sender, RoutedEventArgs e)
   {
       var launcher = Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.GetDefault();
       await launcher.LaunchAsync();
   }
   

Rekomendasi desain untuk antarmuka pengguna umpan balik Anda

Untuk meluncurkan Feedback Hub, kami sarankan Anda menambahkan elemen UI di aplikasi Anda (seperti tombol) yang menampilkan ikon umpan balik standar berikut dari font Aset Segoe MDL2 dan kode karakter E939.

Kami juga menyarankan agar Anda menggunakan satu atau beberapa opsi penempatan berikut untuk menautkan ke Hub Umpan Balik di aplikasi Anda.

• Langsung di bilah aplikasi. Bergantung pada implementasi Anda, Anda mungkin hanya ingin menggunakan ikon atau menambahkan teks (seperti yang ditunjukkan di bawah).

  

• Di pengaturan aplikasi Anda. Ini adalah cara yang lebih halang untuk menyediakan akses ke Feedback Hub. Dalam contoh di bawah ini, tautan Umpan Balik muncul sebagai salah satu tautan di bawah Aplikasi.

  

• Dalam flyout berbasis peristiwa. Ini berguna saat Anda ingin mengkueri pelanggan Anda tentang pertanyaan tertentu sebelum diluncurkan ke Hub Tanggapan Windows. Misalnya, setelah aplikasi menggunakan fitur tertentu, Anda mungkin meminta pelanggan dengan pertanyaan tertentu tentang kepuasan mereka terhadap fitur tersebut. Jika pelanggan memilih untuk merespons, aplikasi Anda akan meluncurkan Feedback Hub.

Topik terkait

• Laporan umpan balik