Angażowanie klientów za pomocą zestawu SDK usług Sklepu Microsoft

Zestaw SDK usług sklepu Microsoft Store udostępnia funkcje, które ułatwiają kontaktowanie się z klientami w aplikacjach platformy uniwersalnej systemu Windows (UWP), takich jak wysyłanie powiadomień docelowych do aplikacji i uruchamianie eksperymentów A/B w aplikacjach. Ten zestaw SDK jest rozszerzeniem programu Visual Studio 2015 i nowszych wersji programu Visual Studio.

Scenariusze obsługiwane przez zestaw SDK usług Sklepu Microsoft

Zestaw SDK usług sklepu Microsoft Store obsługuje obecnie następujące scenariusze dla aplikacji platformy UWP. Aby uzyskać dokumentację referencyjną interfejsu API, zobacz Dokumentacja interfejsu API SDK usług Microsoft Store.

Wymagania wstępne

Zestaw SDK usług sklepu Microsoft Store wymaga:

• Visual Studio 2015 lub nowsza wersja.
• Narzędzia Visual Studio dla aplikacji uniwersalnych Windows zainstalowane z Twoją wersją programu Visual Studio.

Zainstaluj zestaw SDK

Istnieją dwie opcje instalowania zestawu SDK usług Microsoft Store na komputerze dewelopera:

• instalatora MSI Zestaw SDK można zainstalować używając instalatora MSI dostępnego tutaj.
• Pakiet NuGet Zestaw SDK można zainstalować jako pakiet NuGet.

Firma Microsoft okresowo publikuje nowe wersje zestawu MICROSOFT Store Services SDK z ulepszeniami wydajności i nowymi funkcjami. Jeśli masz istniejące projekty korzystające z zestawu SDK i chcesz używać najnowszej wersji, pobierz i zainstaluj najnowszą wersję zestawu SDK na komputerze dewelopera.

Instaluj przez MSI

Aby zainstalować zestaw SDK usług sklepu Microsoft Store za pośrednictwem instalatora MSI:

1. Zamknij wszystkie wystąpienia programu Visual Studio.

2. Jeśli wcześniej zainstalowano zestaw MICROSOFT Store Engagement and Monetization SDK, zestaw SDK klienta usługi Universal Ad lub rozszerzenie Usługi Ad Mediator, odinstaluj te zestawy SDK teraz. Opcjonalnie otwórz okno wiersza polecenia i uruchom następujące polecenia, aby wyczyścić wszystkie starsze wersje zestawu SDK, które mogły zostać zainstalowane w programie Visual Studio, ale które mogą nie być wyświetlane na liście zainstalowanych programów na komputerze:

   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. Pobierz i zainstaluj Zestaw SDK Microsoft Store Services . Instalacja może potrwać kilka minut. Upewnij się, że zaczekasz do zakończenia procesu.

4. Uruchom ponownie program Visual Studio.

5. Jeśli masz istniejący projekt, który odwołuje się do bibliotek z dowolnej wcześniejszej wersji zestawu SDK usług Microsoft Store, zestawu Microsoft Advertising SDK, zestawu SDK klienta usługi Universal Ad lub zestawu SDK zaangażowania i monetyzacji sklepu Microsoft Store, zalecamy otwarcie projektu w programie Visual Studio i oczyszczenie i ponowne skompilowanie projektu (w Eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Wyczyść, a następnie ponownie kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Skompiluj.

W przeciwnym razie, jeśli używasz zestawu SDK po raz pierwszy w projekcie, możesz teraz przystąpić do dodać odwołanie do zestawu do projektu.

Instalowanie za pomocą narzędzia NuGet

Aby zainstalować biblioteki zestawu SDK usług Microsoft Store za pośrednictwem narzędzia NuGet:

1. Zamknij wszystkie wystąpienia programu Visual Studio.

2. Jeśli wcześniej zainstalowano zestaw MICROSOFT Store Engagement and Monetization SDK, zestaw SDK klienta usługi Universal Ad lub rozszerzenie Usługi Ad Mediator, odinstaluj te zestawy SDK teraz. Opcjonalnie otwórz okno wiersza polecenia i uruchom następujące polecenia, aby wyczyścić wszystkie starsze wersje zestawu SDK, które mogły zostać zainstalowane w programie Visual Studio, ale które mogą nie być wyświetlane na liście zainstalowanych programów na komputerze:

   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. Uruchom program Visual Studio i otwórz projekt, w którym chcesz użyć zestawu SDK usług Microsoft Store.

   Uwaga / Notatka

   Jeśli projekt zawiera już odwołania do biblioteki z wcześniejszej instalacji msi zestawu SDK, usuń te odwołania z projektu. Te odwołania będą zawierać obok nich ikony ostrzeżenia, ponieważ biblioteki, do których odwołują się odwołania, zostały usunięte w poprzednich krokach.

4. W programie Visual Studio kliknij pozycję Project i Zarządzaj pakietami NuGet.

5. W polu wyszukiwania wpisz Microsoft.Services.Store.Engagement i zainstaluj pakiet Microsoft.Services.Store.Engagement. Po zakończeniu instalowania pakietu zapisz rozwiązanie.

   Uwaga / Notatka

   Jeśli okno danych wyjściowych zgłasza błąd Install-Package wskazujący, że określona ścieżka jest zbyt długa, może być konieczne skonfigurowanie narzędzia NuGet w celu wyodrębnienia pakietów do alternatywnej lokalizacji z krótszą ścieżką niż lokalizacja domyślna. W tym celu dodaj repositoryPath wartość do pliku nuget.config na komputerze i przypisz ją do krótkiej ścieżki folderu, w której można wyodrębnić pakiety NuGet. Aby uzyskać więcej informacji, zobacz tym artykule w dokumentacji narzędzia NuGet. Alternatywnie możesz spróbować przenieść projekt programu Visual Studio do alternatywnego folderu z krótszą ścieżką. Problem może być również spowodowany zbyt długą ścieżką pakietów globalnych. W takim przypadku dodaj wartość globalPackagesFolder do pliku nuget.config.

6. Zamknij rozwiązanie programu Visual Studio zawierające projekt, a następnie otwórz ponownie rozwiązanie.

7. Jeśli projekt odwołuje się już do bibliotek z wcześniejszej wersji zestawu SDK usług Microsoft Store, który został zainstalowany za pośrednictwem narzędzia NuGet i zaktualizowano projekt do nowszej wersji zestawu SDK, zalecamy wyczyszczenie i ponowne skompilowanie projektu (w Eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz polecenie Wyczyść, a następnie ponownie kliknij węzeł projektu i wybierz polecenie Ponownie skompiluj).

W przeciwnym razie, jeśli używasz zestawu SDK po raz pierwszy w projekcie, możesz teraz przystąpić do dodać odwołanie do zestawu do projektu.

Dodaj odwołanie do zestawu do projektu

Po zainstalowaniu zestawu SDK usług Microsoft Store za pośrednictwem instalatora MSI lub narzędzia NuGet postępuj zgodnie z tymi instrukcjami, aby odwołać się do zestawu SDK w projekcie platformy UWP.

1. Otwórz projekt w programie Visual Studio.

   Uwaga / Notatka

   Jeśli Twój projekt jest aplikacją JavaScript przeznaczoną dla Any CPU, zaktualizuj go, aby używał wyniku kompilacji dostosowanego do danej architektury (na przykład x86).

2. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy Referencje i wybierz Dodaj odwołanie...

3. W Reference Managerrozwiń węzeł Universal Windows, kliknij Extensions, a następnie zaznacz pole wyboru obok Microsoft Engagement Framework. Umożliwia to używanie interfejsów API w przestrzeni nazw Microsoft.Services.Store.Engagement.

4. Kliknij przycisk OK.

Opis pakietów platformowych w zestawie SDK

Biblioteka Microsoft.Services.Store.Engagement.dll w zestawie SDK usług Microsoft Store jest skonfigurowana jako pakiet platformy . Ta biblioteka zawiera interfejsy API w przestrzeni nazw Microsoft.Services.Store.Engagement.

Ponieważ ta biblioteka jest pakietem struktury, oznacza to, że po zainstalowaniu przez użytkownika wersji aplikacji korzystającej z tej biblioteki ta biblioteka jest automatycznie aktualizowana na urządzeniu za pośrednictwem usługi Windows Update po opublikowaniu nowej wersji biblioteki z poprawkami i ulepszeniami wydajności. Dzięki temu klienci zawsze mają najnowszą dostępną wersję biblioteki zainstalowanej na swoich urządzeniach.

Jeśli udostępnimy nową wersję zestawu SDK, która wprowadza nowe interfejsy API lub funkcje w tej bibliotece, należy zainstalować najnowszą wersję zestawu SDK, aby korzystać z tych funkcji. W tym scenariuszu należy również opublikować zaktualizowaną aplikację w Sklepie.

Tematy pokrewne

• Dokumentacja interfejsu API zestawu SDK usług Microsoft Store Services
• Przeprowadzanie eksperymentów z testowaniem A/B
• Uruchom Feedback Hub z aplikacji
• Skonfiguruj aplikację, aby odbierała powiadomienia push z Centrum Partnera
• Rejestrowanie zdarzeń niestandardowych dla Centrum partnerskiego