记录合作伙伴中心的自定义事件

使用情况报告 在合作伙伴中心中, 你可以获取在通用 Windows 平台(UWP)应用中定义的自定义事件的相关信息。 自定义事件是一个任意字符串,表示应用中的事件或活动。 例如,游戏可以定义名为 firstLevelPassedsecondLevelPassed等的自定义事件,当用户在游戏中通过每个级别时,这些事件将被记录。

若要从应用记录自定义事件,请将自定义事件字符串传递给 Microsoft Store Services SDK 提供的 Log 方法。 可以在合作伙伴中心的 使用情况报告 中的 自定义事件 部分查看自定义事件的总数。

注释

登录到合作伙伴中心的自定义事件与 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");
    

    注释

    如果应用记录许多具有长名称的自定义事件,使用情况报告 可能需要很长时间才能加载。 建议对自定义事件使用简短名称。