Поделиться через

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

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

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

Замечание

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

Предпосылки

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

Как регистрировать пользовательские события

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

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

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

  4. В диспетчере ссылок разверните универсальные окна и щелкните "Расширения".

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

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

    using Microsoft.Services.Store.Engagement;

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

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

    Замечание

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