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

  • Статья

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

Примечание.

Чтобы отобразить рекламу в приложениях UWP, используйте пакет SDK Microsoft Advertising вместо пакета SDK служб Microsoft Store. Библиотеки рекламы были перенесены из пакета SDK служб Microsoft Store в пакет SDK Microsoft Advertising. Дополнительные сведения см. в разделе "Отображение рекламы" в приложении.

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

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

Сценарий Description
Выполнение экспериментов в приложении UWP с помощью A/B-тестирования Запустите тесты A/B в приложении универсальная платформа Windows (UWP), чтобы оценить эффективность функций для некоторых клиентов перед выпуском функций всем пользователям. После определения эксперимента в Центре партнеров используйте класс StoreServicesExperimentVariation, чтобы получить варианты эксперимента в приложении, используйте эти данные для изменения поведения проверяемой функции, а затем используйте метод LogForVariation для отправки событий просмотра и преобразования событий в Центр партнеров. Наконец, используйте Центр партнеров для просмотра результатов и управления экспериментом.
Запуск Центра отзывов из приложения UWP Используйте класс StoreServicesFeedbackLauncher в приложении UWP, чтобы направить клиентов Windows 10 и Windows 11 в Центр отзывов, где они могут отправлять проблемы, предложения и upvotes. Затем вы сможете проанализировать все эти данные в отчете об отзывах в Центре партнеров.
Настройка приложения UWP для получения push-уведомлений Центра партнеров Используйте класс StoreServicesEngagementManager в приложении UWP, чтобы зарегистрировать приложение для получения целевых push-уведомлений, отправленных клиентам с помощью Центра партнеров.
Журнал пользовательских событий в приложении UWP для отчета об использовании в Центре партнеров Используйте класс StoreServicesCustomEventLogger в приложении UWP для регистрации пользовательских событий, связанных с приложением в Центре партнеров. Затем просмотрите общее количество событий для пользовательских событий в разделе "Пользовательские события" отчета об использовании в Центре партнеров.

Необходимые компоненты

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

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

Установка пакета SDK

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

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

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

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

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

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

  2. Если вы ранее установили пакет SDK для Microsoft Store Engagement и Монетизации, универсальный клиентский пакет SDK ad или расширение Ad Simon, удалите эти пакеты 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 для Microsoft Store или Microsoft Store Engagement и монетизации, рекомендуется открыть проект в Visual Studio и очистить и перестроить проект (в Обозреватель решений щелкните правой кнопкой мыши узел проекта и выберите "Очистить", а затем снова щелкните узел проекта правой кнопкой мыши и выберите "Перестроить").

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

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

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

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

  2. Если вы ранее установили пакет SDK для Microsoft Store Engagement и Монетизации, универсальный клиентский пакет SDK ad или расширение Ad Simon, удалите эти пакеты 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 щелкните "Проект" и "Управление пакетами 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. В диспетчере ссылок разверните универсальные окна, щелкните расширения и установите флажок рядом с Microsoft Engagement Framework. Это позволяет использовать API в пространстве имен Microsoft.Services.Store.Engagement .

  4. Щелкните OK.

Примечание.

Если вы установили библиотеки SDK через NuGet, проект будет содержать ссылку на Microsoft.Services.Store.Engagement . Справочник по Microsoft.Services.Store.Engagement представляет пакет NuGet (а не библиотеки в нем), и его можно игнорировать.

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

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

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

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