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

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

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

注

フィードバック ハブは、デスクトップおよびモバイル デバイス ファミリに基づく Windows のバージョン 10.0.14271 以降を実行しているデバイスでのみ使用できます。 フィードバック ハブがユーザーのデバイスで利用できる場合にのみ、フィードバック コントロールをアプリに表示することをお勧めします。 このトピックのコードでは、これを行う方法を示します。

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

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

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

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

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

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

  注

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

  次のコードは、前述のように構成された 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 メソッドを使用して、フィードバック ハブがユーザーのデバイスで使用できるかどうかを判断します。 フィードバック ハブは、デスクトップおよびモバイル デバイス ファミリに基づく Windows 10 OS のバージョン 10.0.14271 以降を実行している デバイスでのみ使用できます。

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

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

   注

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

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

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

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

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

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

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

  

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

  

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

関連トピック

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