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

  • 项目

合作伙伴中心的使用情况报告可使你获取有关在通用 Windows 平台 (UWP) 应用中已定义的自定义事件的信息。 自定义事件是表示应用中的某个事件或活动的任意字符串。 例如，游戏可能定义名为 firstLevelPassed、secondLevelPassed 等的自定义事件，用户在游戏中通过每个关卡时记录这些事件。

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

注意

你记录到合作伙伴中心的自定义事件与 Windows 事件无关，它们不会显示在事件查看器中。

先决条件

必须先在应用商店中发布应用，然后才能在合作伙伴中心中查看应用的使用情况报告中的自定义日志记录事件。

如何记录自定义事件

  1. 如果先前尚未这样做，请在开发计算机上安装 Microsoft Store Services SDK。

  2. 在 Visual Studio 中打开项目。

  3. 在“解决方案资源管理器”中，右键单击你的项目的“引用”节点，然后单击“添加引用”。

  4. 在“引用管理器”中，展开“通用 Windows”并单击“扩展”。

  5. 在 SDK 列表中，单击“Microsoft 协议框架”旁边的复选框，然后单击“确定”。

  6. 将以下语句添加到要记录自定义事件的每个代码文件的顶部。

    using Microsoft.Services.Store.Engagement;

  7. 在要记录自定义事件的每个代码部分中，获取 StoreServicesCustomEventLogger 对象，然后调用 Log 方法。 将自定义事件字符串传递到该方法。

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

    注意

    如果应用记录了很多名称很长的自定义事件，则使用情况报告的加载时间可能很长。 建议为自定义事件使用简短的名称。