Ведение журнала пользовательских событий для Центра партнеров

  • Статья

Отчет об использовании в Центре партнеров позволяет получить сведения о пользовательских событиях, определенных в приложении универсальная платформа Windows (UWP). Пользовательское событие — это произвольная строка, представляющая событие или активность в вашем приложении. Например, игра может определять пользовательские события с именем firstLevelPassed, secondLevelPassed и т. д., которые регистрируются при прохождении пользователем каждого уровня в игре.

Для регистрации пользовательского события из вашего приложения передайте строку пользовательского события методу Log, предоставляемому пакетом Microsoft Store Services SDK. Общее количество вхождений пользовательских событий можно просмотреть в разделе Пользовательские событияотчета об использовании в Центре партнеров.

Примечание

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

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

Прежде чем вы сможете просматривать события пользовательского ведения журнала в отчете об использовании приложения в Центре партнеров, приложение должно быть опубликовано в Магазине.

Регистрация пользовательских событий

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

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

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

  4. В диалоговом окне Диспетчер ссылок разверните список Универсальная платформа Windows и выберите Расширения.

  5. В списке пакетов SDK установите флажок рядом с пунктом Microsoft Engagement Framework и нажмите кнопку ОК.

  6. Добавьте следующий оператор в верхнюю часть каждого файла кода, где вы хотите регистрировать пользовательские события.

    using Microsoft.Services.Store.Engagement;

  7. В каждом разделе своего кода, где требуется регистрировать пользовательские события, получите объект StoreServicesCustomEventLogger, а затем вызовите метод Log. Передайте строку пользовательского события в метод.

    StoreServicesCustomEventLogger logger = StoreServicesCustomEventLogger.GetDefault();
logger.Log("myCustomEvent");

    Примечание

    Загрузка отчета об использовании может занять много времени, если ваше приложение регистрирует много пользовательских событий с длинными именами. Мы рекомендуем использовать краткие имена для пользовательских событий.