Starten des Feedback-Hubs über Ihre App
Sie können Ihre Kunden ermutigen, Feedback zu hinterlassen, indem Sie Ihrer Universelle Windows-Plattform (UWP)-App, die den Feedback-Hub startet, ein Steuerelement (z. B. eine Schaltfläche) hinzufügen. Der Feedback-Hub ist eine vorinstallierte App, die einen zentralen Ort zum Sammeln von Feedback zu Windows und installierten Apps bietet. Alle Kundenfeedback, die über den Feedback-Hub für Ihre App übermittelt werden, werden gesammelt und ihnen im Feedbackbericht im Partner Center angezeigt, sodass Sie die Probleme, Vorschläge und Empfehlungen sehen können, die Ihre Kunden in einem Bericht eingereicht haben.
Verwenden Sie zum Starten des Feedback-Hubs aus Ihrer App eine API, die vom Microsoft Store Services SDK bereitgestellt wird. Es wird empfohlen, diese API zum Starten des Feedback-Hubs aus einem UI-Element in Ihrer App zu verwenden, das unsere Designrichtlinien befolgt.
Hinweis
Der Feedback-Hub ist nur auf Geräten verfügbar, auf denen Version 10.0.14271 oder höher eines Windows ausgeführt wird, das auf den Desktop- und Mobilgerätenfamilien basiert. Es wird empfohlen, in Ihrer App nur dann ein Feedbacksteuerelement anzuzeigen, wenn der Feedback-Hub auf dem Gerät des Benutzers verfügbar ist. Der Code in diesem Thema veranschaulicht dies.
So starten Sie den Feedback-Hub über Ihre App
So starten Sie den Feedback-Hub über Ihre App:
- Installieren Sie das Microsoft Store Services SDK.
- Öffnen Sie Ihr Projekt in Visual Studio.
- Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Knoten "Verweise" für Ihr Projekt, und klicken Sie auf "Verweis hinzufügen".
- Erweitern Sie im Verweis-Manager universelle Windows-Geräte, und klicken Sie auf Erweiterungen.
- Klicken Sie in der Liste der SDKs auf das Kontrollkästchen neben Microsoft Engagement Framework , und klicken Sie auf OK.
- Fügen Sie in Ihrem Projekt das Steuerelement hinzu, das Benutzern angezeigt werden soll, um den Feedback-Hub zu starten, z. B. eine Schaltfläche. Es wird empfohlen, das Steuerelement wie folgt zu konfigurieren:
Legen Sie die Schriftart des im Steuerelement angezeigten Inhalts auf Segoe MDL2 Assets fest.
Legen Sie den Text im Steuerelement auf den Hexadezimalzeichencode E939 fest. Dies ist der Zeichencode für das empfohlene Feedbacksymbol in der Schriftart Segoe MDL2 Assets .
Legen Sie die Sichtbarkeit des Steuerelements auf ausgeblendet fest.
Hinweis
Es wird empfohlen, Ihr Feedbacksteuerelement standardmäßig auszublenden und nur dann im Initialisierungscode anzuzeigen, wenn der Feedback-Hub auf dem Gerät des Benutzers verfügbar ist. Im nächsten Schritt wird dies veranschaulicht.
Der folgende Code veranschaulicht die XAML-Definition einer Schaltfläche , die wie oben beschrieben konfiguriert ist.
<Button x:Name="feedbackButton" FontFamily="Segoe MDL2 Assets" Content="" HorizontalAlignment="Left" Margin="138,352,0,0" VerticalAlignment="Top" Visibility="Collapsed" Click="feedbackButton_Click"/>
Verwenden Sie in Ihrem Initialisierungscode für die App-Seite, auf der Ihr Feedbacksteuerelement gehostet wird, die statische IsSupported-Methode der StoreServicesFeedbackLauncher-Klasse , um zu bestimmen, ob der Feedback-Hub auf dem Gerät des Benutzers verfügbar ist. Der Feedback-Hub ist nur auf Geräten verfügbar, auf denen Version 10.0.14271 oder höher eines Windows 10-Betriebssystems ausgeführt wird, das auf desktop- und mobilgeräten Gerätefamilien basiert.
Wenn diese Eigenschaft "true" zurückgibt, machen Sie das Steuerelement sichtbar. Der folgende Code veranschaulicht, wie dies für eine Schaltfläche ausgeführt wird.
if (Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.IsSupported()) { this.feedbackButton.Visibility = Visibility.Visible; }
Hinweis
Obwohl der Feedback-Hub derzeit auf Xbox-Geräten nicht unterstützt wird, gibt die IsSupported-Eigenschaft derzeit "true " auf Xbox-Geräten zurück, auf denen Version 10.0.14271 oder höher von Windows ausgeführt wird. Dies ist ein bekanntes Problem, das in einer zukünftigen Version des Microsoft Store Services SDK behoben wird.
Rufen Sie im Ereignishandler, der ausgeführt wird, wenn der Benutzer auf das Steuerelement klickt, ein StoreServicesFeedbackLauncher-Objekt ab, und rufen Sie die LaunchAsync-Methode auf, um die Feedback Hub-App zu starten. Für diese Methode gibt es zwei Überladungen: eine ohne Parameter und ein weiteres, das ein Wörterbuch mit Schlüssel- und Wertpaaren akzeptiert, die Metadaten enthalten, die Sie dem Feedback zuordnen möchten. Im folgenden Beispiel wird veranschaulicht, wie Sie den Feedback-Hub im Click-Ereignishandler für eine Schaltfläche starten.
private async void feedbackButton_Click(object sender, RoutedEventArgs e) { var launcher = Microsoft.Services.Store.Engagement.StoreServicesFeedbackLauncher.GetDefault(); await launcher.LaunchAsync(); }
Designempfehlungen für Ihre Feedback-UI
Um den Feedback-Hub zu starten, empfehlen wir, ihrer App ein UI-Element (z. B. eine Schaltfläche) hinzuzufügen, das das folgende Standardfeedbacksymbol aus der Schriftart Segoe MDL2 Assets und den Zeichencode E939 anzeigt.
Außerdem wird empfohlen, eine oder mehrere der folgenden Platzierungsoptionen zum Verknüpfen mit dem Feedback-Hub in Ihrer App zu verwenden.
Direkt in der App-Leiste. Je nach Implementierung möchten Sie möglicherweise nur das Symbol verwenden oder Text hinzufügen (wie unten dargestellt).
In den Einstellungen Ihrer App. Dies ist eine subtilere Möglichkeit, den Zugriff auf den Feedback-Hub zu ermöglichen. Im folgenden Beispiel wird der Link "Feedback" als einer der Links unter "App" angezeigt.
In einem ereignisgesteuerten Flyout. Dies ist nützlich, wenn Sie Ihre Kunden vor dem Start in die Windows-Feedback-Hub fragen möchten, um eine bestimmte Frage zu beantworten. Wenn Ihre App beispielsweise ein bestimmtes Feature verwendet, können Sie den Kunden mit einer bestimmten Frage zur Zufriedenheit mit diesem Feature auffordern. Wenn der Kunde antwortet, startet Ihre App den Feedback-Hub.