Freigeben über

Kundengewinnung mit Microsoft Store Services SDK

  • Artikel

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.

Hinweis

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

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.

Szenario Beschreibung
Ausführen von Experimenten in Ihrer UWP-App mit A/B-Tests Führen Sie A/B-Tests in Ihrer Universelle Windows-Plattform (UWP)-App aus, um die Effektivität von Features für einige Kunden zu messen, bevor Sie die Features für alle freigeben. Nachdem Sie ein Experiment im 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 auf den Feedback-Hub zu leiten, in dem sie Probleme, Vorschläge und Empfehlungen ü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 mit Partner Center an Ihre Kunden senden.
Protokollieren von benutzerdefinierten Ereignissen in Ihrer UWP-App für den Nutzungsbericht im 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 Gesamtvorkommnisse für Ihre benutzerdefinierten Ereignisse im Abschnitt "Benutzerdefinierte Ereignisse " des Nutzungsberichts im Partner Center.

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.

Hinweis

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

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.