使用情况报告 在合作伙伴中心中, 你可以获取在通用 Windows 平台(UWP)应用中定义的自定义事件的相关信息。 自定义事件是一个任意字符串,表示应用中的事件或活动。 例如,游戏可以定义名为 firstLevelPassed、secondLevelPassed等的自定义事件,当用户在游戏中通过每个级别时,这些事件将被记录。
若要从应用记录自定义事件,请将自定义事件字符串传递给 Microsoft Store Services SDK 提供的 Log 方法。 可以在合作伙伴中心的 使用情况报告 中的 自定义事件 部分查看自定义事件的总数。
注释
登录到合作伙伴中心的自定义事件与 Windows 事件无关,它们不会显示在 事件查看器中。
先决条件
要查看你在合作伙伴中心中的应用的 使用情况报告 中的自定义日志记录事件,首先你的应用必须在应用商店中发布。
如何记录自定义事件
如果您尚未这样做,在开发计算机上安装 Microsoft Store Services SDK。
在 Visual Studio 中打开项目。
在解决方案资源管理器中,右键单击项目的 引用 节点,然后单击 添加引用。
在 引用管理器中,展开 通用 Windows 并单击 扩展。
在 SDK 列表中,单击 Microsoft Engagement Framework 旁边的复选框,然后单击 确定。
将以下语句添加到要记录自定义事件的每个代码文件的顶部。
using Microsoft.Services.Store.Engagement;
在要记录自定义事件的代码的每个部分中,获取 StoreServicesCustomEventLogger 对象,然后调用 Log 方法。 将自定义事件字符串传递给方法。
StoreServicesCustomEventLogger logger = StoreServicesCustomEventLogger.GetDefault(); logger.Log("myCustomEvent");
注释
如果应用记录许多具有长名称的自定义事件,使用情况报告 可能需要很长时间才能加载。 建议对自定义事件使用简短名称。