Einbinden von Kunden mit dem Microsoft Store Services SDK

Das Microsoft Store Services SDK bietet Features, mit denen Sie mit Kunden in Ihren UWP-Apps (Universelle Windows-Plattform) 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. Für die API-Referenzdokumentation siehe Microsoft Store Services SDK-API-Referenz.

Voraussetzungen

Das Microsoft Store Services SDK erfordert Folgendes:

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

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 MSI-Installationsprogramm installieren, das hierverfügbar ist.
• 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, des Microsoft Advertising SDK, des Universal Ad Client SDK oder des 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 (klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf Ihren Projektknoten, und wählen Sie Bereinigenaus, und dann erneut darauf und wählen Sie Neu erstellen).

Andernfalls, wenn Sie das SDK zum ersten Mal in Ihrem Projekt verwenden, können Sie 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-PaketeVerwalten.

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 das Ausgabefenster einen Install-Package Fehler meldet, der darauf hinweist, dass der angegebene Pfad zu lang ist, müssen Sie möglicherweise NuGet so konfigurieren, dass Pakete an einem alternativen Speicherort mit einem kürzeren Pfad als dem Standardspeicherort extrahiert werden. Fügen Sie dazu einen repositoryPath Wert zu 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 nuget.config Datei 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 im Projektmappen-Explorer mit der rechten Maustaste auf ihren Projektknoten, und wählen Sie " Bereinigen" aus, und klicken Sie dann erneut auf den Projektknoten, und wählen Sie " Neu erstellen" aus.

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

Fügen Sie den Assemblyverweis zu Ihrem Projekt hinzu

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 Ihr Projekt eine JavaScript-App ist, die auf Any CPUausgerichtet ist, aktualisieren Sie Ihr Projekt so, dass eine architekturspezifische Buildausgabe verwendet wird (z. B. x86).

2. Klicken Sie im Solution Explorermit der rechten Maustaste auf Verweise und wählen Sie Verweis hinzufügen...

3. Erweitern Sie in Reference Manager-Universal Windows-, 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. Klicke auf OK.

Grundlegendes zu Frameworkpaketen im SDK

Die Microsoft.Services.Store.Engagement.dll-Bibliothek im Microsoft Store Services SDK ist als Framework-Paketkonfiguriert. 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
• Führen Sie Experimente mit A/B-Tests durch
• Starten Sie den Feedback-Hub aus Ihrer App
• Konfigurieren Sie Ihre App, um Partner Center-Pushbenachrichtigungen zu empfangen
• Protokollieren benutzerdefinierter Ereignisse für Partner Center