Kundengewinnung mit Microsoft Store Services SDK

Artikel
06/02/2023

Die Microsoft Store Services SDK bietet Features, die Ihnen dabei helfen, mit Kunden in Ihren Universelle Windows-Plattform-Apps (UWP) in Kontakt zu treten, z. B. das Senden gezielter Benachrichtigungen an Ihre Apps und das Ausführen von A/B-Experimenten in Ihren Apps. Dieses SDK ist eine Erweiterung für Visual Studio 2015 und neuere Versionen von Visual Studio.

Hinweis

Verwenden Sie zum Anzeigen von Anzeigen in Ihren UWP-Apps das Microsoft Advertising SDK anstelle des Microsoft Store Services SDK. Die Werbebibliotheken wurden vom Microsoft Store Services SDK in das Microsoft Advertising SDK verschoben. Weitere Informationen finden Sie unter Anzeigen von Werbung in Ihrer App.

Vom Microsoft Store Services SDK unterstützte Szenarien

Die Microsoft Store Services SDK unterstützt derzeit die folgenden Szenarien für UWP-Apps. Die API-Referenzdokumentation finden Sie unter Microsoft Store Services SDK API-Referenz.

Szenario	BESCHREIBUNG
Durchführen von Experimenten mit A/B-Tests in Ihrer UWP-App	Führen Sie A/B-Tests in Ihrer App für die universelle Windows-Plattform (UWP) aus, um die Effektivität der Features für einige Kunden zu messen, bevor Sie die Features für alle Benutzer freigeben. Nachdem Sie ein Experiment in Partner Center definiert haben, verwenden Sie die StoreServicesExperimentVariation-Klasse , um Variationen für Ihr Experiment in Ihrer App abzurufen. Verwenden Sie diese Daten, um das Verhalten des features zu ändern, das Sie testen, und verwenden Sie dann die LogForVariation-Methode , um Anzeigeereignisse und Konvertierungsereignisse an Partner Center zu senden. Verwenden Sie schließlich Partner Center, um die Ergebnisse anzuzeigen und das Experiment zu verwalten.
Starten des Feedback-Hubs über Ihre UWP-App	Verwenden Sie die StoreServicesFeedbackLauncher-Klasse in Ihrer UWP-App, um Ihre Windows 10 und Windows 11 Kunden zum Feedback-Hub zu leiten, wo sie Probleme, Vorschläge und Upvotes übermitteln können. Verwalten Sie anschließend dieses Feedback im Feedbackbericht in Partner Center.
Konfigurieren Ihrer UWP-App für den Empfang von Partner Center-Pushbenachrichtigungen	Verwenden Sie die StoreServicesEngagementManager-Klasse in Ihrer UWP-App, um Ihre App zu registrieren, um gezielte Pushbenachrichtigungen zu erhalten, die Sie über Partner Center an Ihre Kunden senden.
Protokollieren von benutzerdefinierten Ereignissen in Ihrer UWP-App für den Nutzungsbericht in Partner Center	Verwenden Sie die StoreServicesCustomEventLogger-Klasse in Ihrer UWP-App, um benutzerdefinierte Ereignisse zu protokollieren, die Ihrer App im Partner Center zugeordnet sind. Überprüfen Sie dann die Gesamtanzahl der Vorkommen für Ihre benutzerdefinierten Ereignisse im Abschnitt Benutzerdefinierte Ereignisse des Nutzungsberichts in Partner Center.

Voraussetzungen

Das Microsoft Store Services SDK erfordert:

Visual Studio 2015 oder eine neuere Version.
Visual Studio-Tools für universelle Windows-Apps, installiert mit Ihrer Version von Visual Studio.

Installieren des SDKs

Es gibt zwei Optionen zum Installieren des Microsoft Store Services SDK auf Ihrem Entwicklungscomputer:

MSI-Installationsprogramm Sie können das SDK über das MSI-Installationsprogramm installieren, das hier verfügbar ist.
NuGet-Paket Sie können das SDK als NuGet-Paket installieren.

Microsoft veröffentlicht in regelmäßigen Abständen neue Versionen des Microsoft Store Services SDKs, die Leistungsverbesserungen und neue Features umfassen. Wenn Sie über vorhandene Projekte verfügen, die das Microsoft Store Services SDK verwenden, und die neueste Version verwenden möchten, laden Sie einfach die neueste Version des SDKs auf Ihren Entwicklungscomputer herunter.

Installation über MSI

So installieren Sie das Microsoft Store-Services-SDK über das MSI-Installationsprogramm:

Schließen Sie alle Instanzen von Visual Studio.
Wenn Sie zuvor das Microsoft Store Engagement and Monetization SDK, das Universal Ad Client SDK oder Ad Mediator-Erweiterung installiert haben, deinstallieren Sie diese SDKs jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster, und führen Sie die folgenden Befehle aus, um alle älteren SDK-Versionen zu sauber, die möglicherweise mit Visual Studio installiert wurden, aber möglicherweise nicht in der Liste der installierten Programme auf Ihrem Computer angezeigt werden:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Laden Sie das Microsoft Store Services SDK herunter, und installieren Sie es. Die Installation kann einige Minuten dauern. Warten Sie unbedingt, bis der Vorgang abgeschlossen ist.
Starten Sie Visual Studio neu.
Wenn Sie über ein vorhandenes Projekt verfügen, das auf Bibliotheken aus einer früheren Version der Microsoft Store Services SDK, des Microsoft Advertising SDK, des Universal Ad Client SDK oder des Microsoft Store Engagement and Monetization SDK verweist, empfiehlt es sich, Das Projekt in Visual Studio zu öffnen und sauber und das Projekt neu zu erstellen (in Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Bereinigen aus, klicken Sie dann erneut mit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Neu erstellen aus.

Andernfalls können Sie, wenn Sie das SDK zum ersten Mal in Ihrem Projekt verwenden, dem Projekt den Assemblyverweis hinzufügen.

Installieren über NuGet

So installieren Sie die Microsoft Store Services SDK-Bibliotheken über NuGet:

Schließen Sie alle Instanzen von Visual Studio.
Wenn Sie zuvor das Microsoft Store Engagement and Monetization SDK, das Universal Ad Client SDK oder Ad Mediator-Erweiterung installiert haben, deinstallieren Sie diese SDKs jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster, und führen Sie die folgenden Befehle aus, um alle älteren SDK-Versionen zu sauber, die möglicherweise mit Visual Studio installiert wurden, aber möglicherweise nicht in der Liste der installierten Programme auf Ihrem Computer angezeigt werden:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Starten Sie Visual Studio, und öffnen Sie das Projekt, in dem Sie die Microsoft Store Services SDK verwenden möchten.

Hinweis

Wenn Ihr Projekt bereits Bibliotheksverweise aus einer früheren MSI-Installation des SDK enthält, entfernen Sie diese Verweise aus Ihrem Projekt. Diese Verweise sind mit Warnsymbolen versehen, da die Bibliotheken, auf die sie verweisen, in den vorherigen Schritten entfernt wurden.
Klicken Sie in Visual Studio auf Projekt und NuGet-Pakete verwalten.
Geben Sie im Suchfeld Microsoft.Services.Store.Engagement ein, und installieren Sie das Microsoft.Services.Store.Engagement-Paket. Wenn die Installation des Pakets abgeschlossen ist, speichern Sie Ihre Lösung.

Hinweis

Wenn im Ausgabefenster ein Installationspaketfehler gemeldet wird, der angibt, dass der angegebene Pfad zu lang ist, müssen Sie NuGet möglicherweise so konfigurieren, dass Pakete an einen alternativen Speicherort mit einem kürzeren Pfad als der Standardspeicherort extrahiert werden. Fügen Sie hierzu den repositoryPath-Wert einer nuget.config-Datei auf Ihrem Computer hinzu, und weisen Sie ihn einem kurzen Ordnerpfad zu, unter dem die NuGet-Pakete extrahiert werden können. Weitere Informationen finden Sie in diesem Artikel in der NuGet-Dokumentation. Sie können auch versuchen, das Visual Studio-Projekt in einen anderen Ordner mit einem kürzeren Pfad zu verschieben. Das Problem kann auch dadurch verursacht werden, dass ihr globaler Paketpfad zu lang ist. Fügen Sie in diesem Fall den globalPackagesFolder Wert ihrer nuget.config-Datei hinzu.
Schließen Sie die Visual Studio-Projektmappe, die Ihr Projekt enthält, und öffnen Sie dann die Projektmappe erneut.
Wenn Ihr Projekt bereits auf Bibliotheken aus einer früheren Version des Microsoft Store Services SDKs verweist, die über NuGet installiert wurde, und Sie Ihr Projekt auf eine neuere Version des SDKs aktualisiert haben, empfehlen wir, das Projekt zu bereinigen und neu zu erstellen (klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, wählen Sie Bereinigen aus, klicken Sie dann mit der rechten Maustaste erneut auf den Projektknoten, und wählen Sie Neu erstellen).

Andernfalls können Sie, wenn Sie das SDK zum ersten Mal in Ihrem Projekt verwenden, dem Projekt den Assemblyverweis hinzufügen.

Hinzufügen des Assemblyverweis zu Ihrem Projekt

Nachdem Sie die Microsoft Store Services SDK über das MSI-Installationsprogramm oder NuGet installiert haben, befolgen Sie diese Anweisungen, um auf die SDK-Assembly in Ihrem UWP-Projekt zu verweisen.

Öffnen Sie Ihr Projekt in Visual Studio.

Hinweis

Wenn es sich bei Ihrem Projekt um eine JavaScript-App mit beliebiger CPU handelt, aktualisieren Sie Ihr Projekt, um eine architekturspezifische Buildausgabe (z. B. x86) zu verwenden.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen... aus.
Erweitern Sie im Verweis-Managerdie Option Universelle Fenster, klicken Sie auf Erweiterungen, und aktivieren Sie dann das Kontrollkästchen neben Microsoft Engagement Framework. Dadurch können Sie die APIs im Microsoft.Services.Store.Engagement-Namespace verwenden.
Klicken Sie auf OK.

Hinweis

Wenn Sie die SDK-Bibliotheken über NuGet installiert haben, enthält Ihr Projekt eine Microsoft.Services.Store.Engagement-Referenz . Die Microsoft.Services.Store.Engagement-Referenz stellt das NuGet-Paket (und nicht die darin enthaltenen Bibliotheken) dar, und Sie können es ignorieren.

Die Frameworkpakete in dem SDK

Die Microsoft.Services.Store.Engagement.dll-Bibliothek im Microsoft Store Services SDK wird als Frameworkpaket konfiguriert. Diese Bibliothek enthält die APIs im Microsoft.Services.Store.Engagement-Namespace.

Da es sich bei dieser Bibliothek um ein Frameworkpaket handelt, bedeutet dies, dass nach der Installation einer Version Ihrer App, die diese Bibliothek verwendet, diese Bibliothek automatisch auf dem Gerät über Windows Update aktualisiert wird, wenn wir eine neue Version der Bibliothek mit Korrekturen und Leistungsverbesserungen veröffentlichen. Dadurch können Sie sicherstellen, dass Ihre Kunden immer die neueste verfügbare Version der Bibliothek auf ihren Geräten installiert haben.

Wenn wir eine neue Version des SDK veröffentlichen, die neue APIs oder Features in dieser Bibliothek einführt, müssen Sie die neueste Version des SDK installieren, um diese Features verwenden zu können. In diesem Szenario müssen Sie auch die aktualisierte App im Store veröffentlichen.