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

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

  • Статья

Отчет об использовании в Центре партнеров позволяет получить сведения о пользовательских событиях, определенных в приложении универсальная платформа 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");

    Примечание.

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