Kundengewinnung mit Microsoft Store Services SDK

Das Microsoft Store Services SDK bietet Features, mit denen Sie mit Kunden in Ihren Universelle Windows-Plattform (UWP)-Apps interagieren können, z. B. das Senden von gezielten 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 höhere Versionen von Visual Studio.

Vom Microsoft Store Services SDK unterstützte Szenarien

Das Microsoft Store Services SDK unterstützt derzeit die folgenden Szenarien für UWP-Apps. Api-Referenzdokumentation finden Sie in der API-Referenz zur Microsoft Store Services SDK-API.

Voraussetzungen

Das Microsoft Store Services SDK erfordert Folgendes:

• Visual Studio 2015 oder eine höhere Version.
• Visual Studio-Tools für universelle Windows-Apps, die mit Ihrer Version von Visual Studio installiert sind.

Das SDK installieren

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

• MSI-Installationsprogramm Sie können das SDK über das hier verfügbare MSI-Installationsprogramm installieren.
• NuGet-Paket Sie können das SDK als NuGet-Paket installieren.

Microsoft veröffentlicht regelmäßig neue Versionen des Microsoft Store Services SDK mit Leistungsverbesserungen und neuen Features. Wenn Sie über vorhandene Projekte verfügen, die das SDK verwenden und die neueste Version verwenden möchten, laden Sie die neueste Version des SDK auf Ihrem Entwicklungscomputer herunter, und installieren Sie es.

Installieren über MSI

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

1. Schließen Sie alle Instanzen von Visual Studio.

2. Wenn Sie zuvor das Microsoft Store Engagement and Monetization SDK, das Universal Ad Client SDK oder die Ad Mediator-Erweiterung installiert haben, deinstallieren Sie diese SDKs jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster , und führen Sie diese Befehle aus, um ältere SDK-Versionen zu bereinigen, 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}
   

3. Laden Sie das Microsoft Store Services SDK herunter, und installieren Sie es. Es kann einige Minuten dauern, bis die Installation erfolgt. Achten Sie darauf, und warten Sie, bis der Vorgang abgeschlossen ist.

4. Starten Sie Visual Studio neu.

5. Wenn Sie über ein vorhandenes Projekt verfügen, das auf Bibliotheken aus einer früheren Version des Microsoft Store Services SDK, Microsoft Advertising-SDK, universal Ad Client SDK oder microsoft Store Engagement and Monetization SDK verweist, empfehlen wir, Ihr Projekt in Visual Studio zu öffnen und Ihr Projekt zu bereinigen und neu zu erstellen (in Projektmappen-Explorerklicken Sie mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Bereinigen" aus, und klicken Sie dann erneut mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neu erstellen" aus.

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

Installieren über NuGet

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

1. Schließen Sie alle Instanzen von Visual Studio.

2. Wenn Sie zuvor das Microsoft Store Engagement and Monetization SDK, das Universal Ad Client SDK oder die Ad Mediator-Erweiterung installiert haben, deinstallieren Sie diese SDKs jetzt. Öffnen Sie optional ein Eingabeaufforderungsfenster , und führen Sie diese Befehle aus, um ältere SDK-Versionen zu bereinigen, 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}
   

3. Starten Sie Visual Studio, und öffnen Sie das Projekt, in dem Sie das 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 weisen Warnungssymbole neben ihnen auf, da die Bibliotheken, auf die sie verweisen, in den vorherigen Schritten entfernt wurden.

4. Klicken Sie in Visual Studio auf "Projekt" und "NuGet-Pakete verwalten".

5. 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 möglicherweise NuGet so konfigurieren, dass Pakete an einen alternativen Speicherort mit einem kürzeren Pfad als dem Standardspeicherort extrahiert werden. Fügen Sie dazu den repositoryPath Wert einer Nuget.config-Datei auf Ihrem Computer hinzu, und weisen Sie ihn einem kurzen Ordnerpfad zu, in dem NuGet-Pakete extrahiert werden können. Weitere Informationen finden Sie in diesem Artikel in der NuGet-Dokumentation. Alternativ können Sie versuchen, Ihr Visual Studio-Projekt in einen alternativen Ordner mit einem kürzeren Pfad zu verschieben. Das Problem könnte auch dadurch verursacht werden, dass der globale Paketpfad zu lang ist. Fügen Sie in diesem Fall den globalPackagesFolder Wert zu Ihrer Datei "nuget.config" hinzu.

6. Schließen Sie die Visual Studio-Projektmappe, die Ihr Projekt enthält, und öffnen Sie dann die Projektmappe erneut.

7. Wenn Ihr Projekt bereits auf Bibliotheken aus einer früheren Version des Microsoft Store Services SDK verweist, das über NuGet installiert wurde und Sie Ihr Projekt auf eine neuere Version des SDK aktualisiert haben, empfehlen wir, das Projekt zu bereinigen und neu zu erstellen (klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ihren Projektknoten, und wählen Sie "Bereinigen" aus, und klicken Sie dann erneut mit der rechten Maustaste auf den Projektknoten, und wählen Sie "Neu erstellen" aus.

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

Hinzufügen des Assemblyverweises zu Ihrem Projekt

Nachdem Sie das 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.

1. Öffnen Sie Ihr Projekt in Visual Studio.

   Hinweis

   Wenn Es sich bei Ihrem Projekt um eine JavaScript-App handelt, die auf "Any CPU" ausgerichtet ist, aktualisieren Sie Ihr Projekt so, dass eine architekturspezifische Buildausgabe verwendet wird (z. B. x86).

2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf "Verweise", und wählen Sie "Verweis hinzufügen" aus...

3. Erweitern Sie im Verweis-Manager universelle Windows-Geräte, klicken Sie auf Erweiterungen, und aktivieren Sie dann das Kontrollkästchen neben Microsoft Engagement Framework. Auf diese Weise können Sie die APIs im Namespace "Microsoft.Services.Store.Engagement " verwenden.

4. Klicken Sie auf OK.

Grundlegendes zu Frameworkpaketen im SDK

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

Da es sich bei dieser Bibliothek um ein Frameworkpaket handelt, bedeutet dies, dass diese Bibliothek automatisch über Windows Update aktualisiert wird, wenn eine neue Version der Bibliothek mit Korrekturen und Leistungsverbesserungen veröffentlicht wird, nachdem ein Benutzer eine Version Ihrer App installiert hat, die diese Bibliothek verwendet. 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 zu verwenden. In diesem Szenario müssen Sie ihre aktualisierte App auch im Store veröffentlichen.

Zugehörige Themen

• Microsoft Store Services SDK-API-Referenz
• Ausführen von Experimenten mit A/B-Tests
• Starten des Feedback-Hubs über Ihre App
• Konfigurieren Ihrer App zum Empfangen von Partner Center-Pushbenachrichtigungen
• Protokollieren benutzerdefinierter Ereignisse im Partner Center