アプリからのフィードバック Hub の起動

フィードバック Hub を起動する ユニバーサル Windows プラットフォーム (UWP) アプリにコントロール (ボタンなど) を追加することで、顧客にフィードバックを残すように促すことができます。 Feedback Hub は、Windows とインストールされているアプリに関するフィードバックを収集するための 1 つの場所を提供するプレインストールアプリです。 フィードバック Hub を介してアプリに送信されたすべてのカスタマー フィードバックは、パートナー センターのフィードバック レポートで収集および表示されるため、ユーザーが送信した問題、提案、賛成票を 1 つのレポートで確認できます。

アプリからフィードバック ハブを起動するには、 Microsoft Store Services SDK によって提供される API を使用します。 この API を使用して、設計ガイドラインに従ってアプリの UI 要素からフィードバック ハブを起動することをお勧めします。

アプリからフィードバック ハブを起動する方法

アプリからフィードバック ハブを起動するには:

1. Microsoft Store Services SDK をインストールします。
2. Visual Studio でプロジェクトを開きます。
3. ソリューション エクスプローラーで、プロジェクトの [参照設定] ノードを右クリックし、[参照の追加] をクリックします。
4. [参照マネージャー] で、[ユニバーサル Windows] を展開し、[拡張機能] をクリックします。
5. SDK の一覧で、[Microsoft Engagement Framework] の横にあるチェック ボックスをオンにして、[OK] をクリックします。
6. プロジェクトで、フィードバック ハブを起動するためにユーザーに表示するコントロール (ボタンなど) を追加します。 次のようにコントロールを構成することをお勧めします。

• コントロールに表示されるコンテンツのフォントを Segoe MDL2 Assets に設定します。

• コントロール内のテキストを 16 進数の Unicode 文字コード E939 に設定します。 これは、 Segoe MDL2 Assets フォントの推奨されるフィードバック アイコンの文字コードです。

• コントロールの可視性を非表示に設定します。

  Note

  フィードバック コントロールは、既定では非表示にし、ユーザーのデバイスでフィードバック ハブが使用可能な場合にのみ、初期化コードに表示することをお勧めします。 次の手順では、これを行う方法を示します。

  次のコードは、前述のように構成された Button の XAML 定義を示しています。

  <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. フィードバック コントロールをホストするアプリ ページの初期化コードで、StoreServicesFeedbackLauncher クラスの静的IsSupported メソッドを使用して、フィードバック ハブがユーザーのデバイスで使用できるかどうかを判断します。 フィードバック ハブは、デスクトップおよびモバイル device ファミリに基づく Windows 10 OS のバージョン 10.0.14271 以降を実行するデバイスでのみ使用できます。

   このプロパティが true を返す場合は、コントロールを表示します。 次のコードは、 Button に対してこれを行う方法を示しています。

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

   Note

   現時点では、フィードバック ハブは Xbox デバイスではサポートされていませんが、 IsSupported プロパティは現在、バージョン 10.0.14271 以降の Windows を実行する Xbox デバイスで true を返します。 これは、Microsoft Store Services SDK の今後のリリースで修正される既知の問題です。

8. ユーザーがコントロールをクリックしたときに実行されるイベント ハンドラーで、 StoreServicesFeedbackLauncher オブジェクトを取得し、 LaunchAsync メソッドを呼び出してフィードバック ハブ アプリを起動します。 このメソッドには、パラメーターのないオーバーロードと、フィードバックに関連付けるメタデータを含むキーと値のペアのディクショナリを受け入れるオーバーロードの 2 つがあります。 次の例では、Button の Click イベント ハンドラーでフィードバック ハブを起動する方法を示します。

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

フィードバック UI の設計に関する推奨事項

フィードバック ハブを起動するには、Segoe MDL2 Assets フォントと文字コード E939 から次の標準フィードバック アイコンを表示する UI 要素 (ボタンなど) をアプリに追加することをお勧めします。

また、アプリのフィードバック ハブにリンクするには、次の配置オプションの 1 つ以上を使用することをお勧めします。

• アプリ バーで直接。 実装によっては、アイコンのみを使用するか、テキストを追加することができます (次に示すように)。

  

• アプリの設定で。 これは、フィードバック ハブへのアクセスを提供するためのより微妙な方法です。 次の例では、[フィードバック] リンクが [アプリ] の下のリンクの 1 つとして表示されます。

  

• イベント ドリブン ポップアップで。 これは、Windows フィードバック Hubを開始する前に、特定の質問について顧客にクエリを実行する場合に便利です。 たとえば、アプリで特定の機能を使用した後、その機能に対する満足度に関する特定の質問を顧客に求めることができます。 顧客が応答を選択した場合、アプリはフィードバック ハブを起動します。

関連トピック

• フィードバック レポート