透過 Microsoft Store Services SDK 與客戶互動

發行項
04/01/2024

Microsoft Store Services SDK 提供的功能可協助您與通用 Windows 平台 (UWP) 應用程式中的客戶互動，例如將針對性的通知傳送至您的應用程式，以及在應用程式中執行 A/B 實驗。此 SDK 是 Visual Studio 2015 和更新版本的 Visual Studio 延伸模組。

注意

若要在 UWP 應用程式中顯示廣告，請使用 Microsoft Advertising SDK，而不是 Microsoft Store Services SDK。廣告程式庫已從 Microsoft Store Services SDK 移至 Microsoft Advertising SDK。如需詳細資訊，請參閱在您的應用程式中顯示廣告。

Microsoft Store Services SDK 支援的情況

Microsoft Store Services SDK 目前支援下列 UWP 應用程式情況。如需 API 參考文件，請參閱 Microsoft Store Services SDK API 參考。

案例	描述
使用 A/B 測試在 UWP 應用程式中執行實驗	在您通用 Windows 平台 (UWP) 應用程式中執行 A/B 測試，以在將功能發佈給所有人之前，先在某些客戶上測量功能的有效性。在合作夥伴中心定義實驗之後，請使用 StoreServicesExperimentVariation 類別來取得您應用程式中實驗的變化，使用此資料來修改您正在測試的功能行為，然後使用 LogForVariation 方法將檢視事件和轉換事件傳送至合作夥伴中心。最後，使用合作夥伴中心來檢視結果並管理實驗。
從 UWP 應用程式啟動意見反應中樞	使用 UWP 應用程式中的 StoreServicesFeedbackLauncher 類別將 Windows 10 和 Windows 11 客戶導向到意見反應中樞，他們可以在其中提交問題、建議和附議。然後，在「合作夥伴中心」的意見反應報告中管理此意見反應。
設定您的 UWP 應用程式以接收合作夥伴中心推送通知	使用 UWP 應用程式中的 StoreServicesEngagementManager 類別來註冊您的應用程式，以接收您使用合作夥伴中心傳送給客戶的針對性推送通知。
在 UWP 應用程式中記錄自訂事件，以便在合作夥伴中心獲得使用方式報告	使用 UWP 應用程式中的 StoreServicesCustomEventLogger 類別，在合作夥伴中心記錄與您的應用程式相關聯的自訂事件。接著，您可以在合作夥伴中心使用量報告中的自訂事件區段檢閱自訂事件的總數。

必要條件

Microsoft Store Services SDK 需要：

Visual Studio 2015 或更新版本。
Visual Studio Tools for Universal Windows Apps 會隨您的 Visual Studio 版本一起安裝。

安裝 SDK

在您的開發電腦上安裝 Microsoft Store Services SDK 有兩個選項：

MSI 安裝程式：您可以透過這裡提供的 MSI 安裝程式來安裝 SDK。
NuGet 套件：您可以將 SDK 安裝為 NuGet 套件。

Microsoft 會定期發行具有效能改進和新功能的 Microsoft Store Services SDK 新版本。如果您有使用 SDK 的現有專案且想要使用最新版本，請在開發電腦上下載並安裝最新版本的 SDK。

透過 MSI 安裝

若要透過 MSI 安裝程式安裝 Microsoft Store Services SDK：

關閉所有 Visual Studio 執行個體。
如果您先前已安裝 Microsoft Store Engagement 和 Monetization SDK、 Universal Ad Client SDK 或 Ad Mediator 延伸模組，請立即取消安裝這些 SDK。或者，開啟 [命令提示字元] 視窗並執行下列命令，以清除任何舊版 SDK 版本，這些版本可能已隨 Visual Studio 一起安裝，但可能未出現在您電腦上的已安裝程式清單中：
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
下載並安裝 Microsoft Store Services SDK。安裝可能需要幾分鐘的時間。請確定並等到程序完成為止。
重新啟動 Visual Studio。
如果您有參考任何舊版 Microsoft Store Services SDK、Microsoft Advertising SDK、Universal Ad Client SDK 或 Microsoft Store Engagement 和 Monetization SDK 之程式庫的現有專案，建議您在 Visual Studio 中開啟專案，然後清除和重建您的專案 (在 [方案總管]中，以滑鼠右鍵按一下您的專案節點，然後選擇 [清除]，然後再次以滑鼠右鍵按一下您的專案節點，然後選擇 [重建])。

否則，如果您是在專案中第一次使用 SDK，您現在已準備好將組件參考新增至專案。

透過 NuGet 安裝

若要透過 NuGet 安裝 Microsoft Store Services SDK 程式庫：

關閉所有 Visual Studio 執行個體。
如果您先前已安裝 Microsoft Store Engagement 和 Monetization SDK、 Universal Ad Client SDK 或 Ad Mediator 延伸模組，請立即取消安裝這些 SDK。或者，開啟 [命令提示字元] 視窗並執行下列命令，以清除任何舊版 SDK 版本，這些版本可能已隨 Visual Studio 一起安裝，但可能未出現在您電腦上的已安裝程式清單中：
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
啟動 Visual Studio，然後開啟您要使用 Microsoft Store Services SDK 的專案。

注意

如果您的專案已經包含 SDK 舊版 MSI 安裝的程式庫參考，請從專案中移除這些參考。這些參考旁邊會有警告圖示，因為它們參考的程式庫已在先前的步驟中移除。
在 Visual Studio 中，按一下 [專案] 和 [管理 NuGet 套件]。
在搜尋方塊中，輸入 [Microsoft.Services.Store.Engagement] 並安裝 Microsoft.Services.Store.Engagement 套件。當套件完成安裝時，請儲存您的方案。

注意

如果 [輸出] 視窗報告「安裝-套件」錯誤，指出指定的路徑太長，您可能需要設定 NuGet，將套件擷取到路徑比預設位置短的替代位置。若要這麼做，請將 repositoryPath 值新增至電腦上的 nuget.config 檔案，並將它指派給可將 NuGet 套件解壓縮的簡短資料夾路徑。如需詳細資訊，請參閱 NuGet 文件中的這篇文章。或者，您也可以嘗試將 Visual Studio 專案移至具有較短路徑的替代資料夾。問題也可能是因為您的全域套件路徑太長所造成。在此情況下，請將 globalPackagesFolder 值新增至 nuget.config 檔案。
關閉包含您專案的 Visual Studio 方案，然後重新開啟方案。
如果您的專案已經參考透過 NuGet 安裝的舊版 Microsoft Store Services SDK 程式庫，而且您已將專案更新為較新版本的 SDK，建議您清除並重建專案 (在 [方案總管] 中，以滑鼠右鍵按一下您的專案節點，然後選擇 [清除]，然後再次以滑鼠右鍵按一下您的專案節點，然後選擇 [重建])。

否則，如果您是在專案中第一次使用 SDK，您現在已準備好將組件參考新增至專案。

西增對您專案的組件參考

透過 MSI 安裝程式或 NuGet 安裝 Microsoft Store Services SDK 之後，請遵循這些指示來參考 UWP 專案中的 SDK 組件。

在 Visual Studio 中，開啟您的專案。

注意

如果您的專案是以任何 CPU 為目標的 JavaScript 應用程式，請更新您的專案以使用架構特定的組建輸出 (例如 x86)。
在 [方案總管] 中，以滑鼠右鍵按一下 [參考]，然後選取 [新增參考...]。
在 [參考管理員] 中，展開 [通用 Windows]，按一下 [延伸模組]，然後選取 Microsoft Engagement Framework 旁的核取方塊。這可讓您使用 Microsoft.Services.Store.Engagement 命名空間中的 API。
按一下 [確定]。

注意

如果您透過 NuGet 安裝 SDK 程式庫，您的專案將會包含 Microsoft.Services.Store.Engagement 參考。 Microsoft.Services.Store.Engagement 參考代表 NuGet 套件 (而非其中的程式庫)，而且您可以忽略它。

瞭解 SDK 中的架構套件

Microsoft Store Services SDK 中的 Microsoft.Services.Store.Engagement.dll 程式庫會設定為架構套件。此程式庫包含 Microsoft.Services.Store.Engagement 命名空間中的 API。

因為此程式庫是架構套件，這表示在使用者安裝使用此程式庫的應用程式版本之後，每當我們發佈包含修正和效能改善的新版本程式庫時，都會透過 Windows Update 在其裝置上自動更新此程式庫。這有助於確保您的客戶一律在其裝置上安裝最新可用的程式庫版本。

如果我們在此程式庫中發行引進新 API 或功能的新版本 SDK，您必須安裝最新版本的 SDK，才能使用這些功能。在這種情況下，您也需要將更新的應用程式發佈至 Store。