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

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

Примечание

Для отображения рекламы в приложениях UWP используйте Microsoft Advertising SDK вместо Microsoft Store Services SDK. Рекламные библиотеки были перемещены из Microsoft Store Services SDK в Microsoft Advertising SDK. Дополнительные сведения см. в статье Показ рекламы в приложениях.

Сценарии, поддерживаемые Microsoft Store Services SDK

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

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

Предварительные требования

Microsoft Store Services SDK предъявляет следующие требования.

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

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

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

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

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

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

Установка Microsoft Store Services SDK с помощью установщика MSI.

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

  2. Если вы ранее устанавливали Microsoft Store Engagement and Monetization SDK, Universal Ad Client 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. Скачайте и установите пакет Microsoft Store Services SDK. Установка может занять несколько минут. Обязательно дождитесь завершения процесса.

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

  5. Если у вас есть существующий проект, который ссылается на библиотеки из какой-либо более ранней версии пакетов Microsoft Store Services SDK, Microsoft Advertising SDK, Universal Ad Client SDK или Microsoft Store Engagement and Monetization SDK, рекомендуется открыть этот проект в Visual Studio, очистить и заново собрать проект (в Обозревателе решений щелкните правой кнопкой мыши по узлу проекта и выберите пункт Очистить, а затем снова щелкните правой кнопкой мыши по узлу проекта и выберите Пересобрать).

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

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

Установка библиотек Microsoft Store Services SDK с помощью NuGet.

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

  2. Если вы ранее устанавливали Microsoft Store Engagement and Monetization SDK, Universal Ad Client 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 и откройте проект, в котором вы хотите использовать Microsoft Store Services SDK.

    Примечание

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

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

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

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

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

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

    Примечание

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

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

  3. В Диспетчере ссылок разверните универсальные для Windows, нажмите Расширения и затем установите флажок рядом с пунктом Microsoft Engagement Framework. Это позволяет использовать API в пространстве имен Microsoft.Services.Store.Engagement.

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

Примечание

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

Понимание пакетов платформы в SDK

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

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

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