Share via

記錄合作夥伴中心的自訂事件

  • 發行項

合作夥伴中心的使用量報告可讓您取得您在通用 Windows 平台 (UWP) 應用程式中定義的自訂事件相關資訊。 自訂事件是代表應用程式中事件或活動的任意字串。 例如，遊戲可能會定義名為 firstLevelPassed、、secondLevelPassed 等的自訂事件，則當使用者在遊戲中傳遞每個層級時會記錄這些事件。

若要從您的應用程式記錄自訂事件，請將自訂事件字串傳遞至 Microsoft Store Services SDK 所提供的 Log 方法。 您可以在合作夥伴中心使用量報告中的自訂事件 區段檢閱自訂事件的總數。

注意

您登入合作夥伴中心的自訂事件與 Windows 事件無關，而且它們不會出現在事件檢視器中。

必要條件

您必須先在 Store 中發佈您的應用程式，才能在合作夥伴中心檢閱您應用程式使用量報告中 的自訂記錄事件。

如何記錄自訂事件

  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");

    注意

    如果您的應用程式記錄許多具有長名稱的自訂事件，使用量報告可能需要很長的時間才能載入。 建議您對自訂事件使用簡短名稱。