Привлечение пользователей с помощью Microsoft Store Services SDK

Пакет SDK служб Microsoft Store предоставляет функции, которые помогают взаимодействовать с клиентами в приложениях универсальной платформы Windows (UWP), например отправлять целевые уведомления в приложения и запускать эксперименты A/B в приложениях. Этот пакет SDK является расширением для Visual Studio 2015 и более поздних версий Visual Studio.

Сценарии, поддерживаемые пакетом SDK служб Microsoft Store

Пакет SDK служб Microsoft Store в настоящее время поддерживает следующие сценарии для приложений UWP. Для получения справочной документации по API см. в API-справочник SDK служб Microsoft Store.

Предпосылки

Для пакета SDK служб Microsoft Store требуется:

• Visual Studio 2015 или более поздней версии.
• Инструменты Visual Studio для универсальных приложений Windows, установленные с вашей версией Visual Studio.

Установите SDK

Существует два варианта установки пакета SDK служб Microsoft Store на компьютере разработки:

• Установщик MSI Пакет SDK можно установить с помощью установщика MSI, доступного здесь.
• пакет NuGet Вы можете установить SDK в виде пакета NuGet.

Корпорация Майкрософт периодически выпускает новые версии пакета SDK служб Microsoft Store с улучшениями производительности и новыми функциями. Если у вас есть проекты, использующие пакет SDK, и вы хотите использовать последнюю версию, скачайте и установите последнюю версию пакета SDK на компьютере разработки.

Установка с помощью MSI

Чтобы установить пакет SDK служб Microsoft Store с помощью установщика MSI, выполните следующие действия.

1. Закройте все экземпляры Visual Studio.

2. Если вы ранее установили пакет SDK для Microsoft Store Engagement и монетизации, универсальный пакет SDK клиентской рекламы или расширение Ad Mediator, удалите эти пакеты SDK. При необходимости откройте окно командной строки и выполните эти команды, чтобы очистить все старые версии пакета SDK, которые могли быть установлены с помощью Visual Studio, но которые могут не отображаться в списке установленных программ на компьютере:

   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. Скачайте и установите пакет SDKслужб Microsoft Store. Установка может занять несколько минут. Не забудьте дождаться завершения процесса.

4. Перезапустите Visual Studio.

5. Если у вас есть существующий проект, который ссылается на библиотеки из любой более ранней версии пакета SDK служб Microsoft Store, пакета SDK Microsoft Advertising, пакета SDK для универсального клиента объявлений или пакета SDK Microsoft Store Engagement и Монетизации, мы рекомендуем открыть ваш проект в Visual Studio и очистить и перестроить его (в Обозревателе решенийщелкните узел вашего проекта правой кнопкой мыши и выберите Очистить, а затем снова щелкните узел проекта правой кнопкой мыши и выберите Перестроить).

В противном случае, если вы используете пакет SDK впервые в проекте, вы теперь готовы добавить в проект ссылку на сборку.

Установка с помощью NuGet

Чтобы установить библиотеки пакета SDK служб Microsoft Store через NuGet, выполните следующие действия.

1. Закройте все экземпляры Visual Studio.

2. Если вы ранее установили пакет SDK для Microsoft Store Engagement и монетизации, универсальный пакет SDK клиентской рекламы или расширение Ad Mediator, удалите эти пакеты SDK. При необходимости откройте окно командной строки и выполните эти команды, чтобы очистить все старые версии пакета SDK, которые могли быть установлены с помощью Visual Studio, но которые могут не отображаться в списке установленных программ на компьютере:

   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. Запустите Visual Studio и откройте проект, в котором вы хотите использовать пакет SDK служб Microsoft Store.

   Замечание

   Если проект уже содержит ссылки на библиотеки из более ранней установки MSI пакета SDK, удалите эти ссылки из проекта. Эти ссылки будут иметь значки предупреждения рядом с ними, так как библиотеки, на которые они ссылаются, были удалены на предыдущих шагах.

4. В Visual Studio щелкните Project и Управление пакетами NuGet.

5. В поле поиска введите Microsoft.Services.Store.Engagement и установите пакет Microsoft.Services.Store.Engagement. После установки пакета сохраните решение.

   Замечание

   Если окно вывода сообщает об ошибке Install-Package, указывающей, что указанный путь слишком длинный, может понадобиться настроить NuGet таким образом, чтобы извлечь пакеты в альтернативное расположение с более коротким путем, чем в расположении по умолчанию. Для этого добавьте repositoryPath значение в файл nuget.config на компьютере и назначьте его короткому пути к папке, в которой можно извлечь пакеты NuGet. Дополнительные сведения см. в этой статье документации NuGet. Кроме того, можно попробовать переместить проект Visual Studio в альтернативную папку с более коротким путем. Проблема также может быть вызвана слишком длинным путьом к глобальным пакетам. В этом случае добавьте значение globalPackagesFolder в файл nuget.config.

6. Закройте решение Visual Studio, содержащее проект, и снова откройте решение.

7. Если проект уже ссылается на библиотеки из более ранней версии пакета SDK служб Microsoft Store, установленного с помощью NuGet, и вы обновили проект до более нового выпуска пакета SDK, мы рекомендуем очистить и перестроить проект (в обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите "Очистить", а затем снова щелкните узел проекта правой кнопкой мыши и выберите " Перестроить").

В противном случае, если вы используете пакет SDK впервые в проекте, вы теперь готовы добавить в проект ссылку на сборку.

Добавьте ссылку на сборку в проект

После установки пакета SDK служб Microsoft Store с помощью установщика MSI или NuGet следуйте этим инструкциям, чтобы ссылаться на сборку пакета SDK в проекте UWP.

1. Откройте проект в Visual Studio.

   Замечание

   Если проект является приложением JavaScript, предназначенным для любойЦП, обновите проект, чтобы использовать выходные данные сборки для конкретной архитектуры (например, x86).

2. В Обозревателе решений щелкните правой кнопкой мыши Ссылки и выберите Добавить ссылку...

3. В Reference Managerразверните Universal Windows, щелкните Extensions, а затем установите флажок рядом с Microsoft Engagement Framework. Это позволяет использовать API в пространстве имен Microsoft.Services.Store.Engagement .

4. Нажмите кнопку ОК.

Общие сведения о пакетах платформы в пакете SDK

Библиотека Microsoft.Services.Store.Engagement.dll в пакете SDK служб Microsoft Store настроена как пакет платформы. Эта библиотека содержит API в пространстве имен Microsoft.Services.Store.Engagement.

Так как эта библиотека является пакетом платформы, это означает, что после установки пользователем версии приложения, использующего эту библиотеку, эта библиотека автоматически обновляется на своем устройстве с помощью Центра обновления Windows при публикации новой версии библиотеки с исправлениями и улучшениями производительности. Это помогает гарантировать, что клиенты всегда имеют последнюю доступную версию библиотеки, установленной на своих устройствах.

Если мы выпускаем новую версию пакета SDK, включающую новые API или компоненты этой библиотеки, необходимо установить последнюю версию пакета SDK для использования этих функций. В этом сценарии также потребуется опубликовать обновленное приложение в Магазине.

Связанные темы

• Справочник API SDK для Услуг Microsoft Store
• Проведение экспериментов с A/B-тестированием
• Запуск Центра отзывов из приложения
• Настройка приложения для получения push-уведомлений Центра партнеров
• Ведение журнала пользовательских событий для Центра партнеров